X (Twitter) user's posts by handle or user id

TikHub

What this API does

Recent posts of an X (Twitter) user Retrieve one bounded result or page. Pagination is explicit; each follow-up page is another call. The catalog price is the maximum per request. Quotes use the selected limits; settlement is verified supplier cost plus 40%, with a $0.0025 minimum per successful call, including supplier waivers and successful no-match results. Read public social data without a connected social account. Results include reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most one selected item from each list.

Agents select this operation with tool ID tikhub.user-posts, then check its current inputs and price before a run.

Inputs and outputs

Input

cursorstring · optional

pagination cursor from the previous response

minLength: 1 · maxLength: 4096

rest_idstring · optional

Numeric X user ID, supplied as a string to preserve every digit.

minLength: 1 · maxLength: 25

screen_namestring · optional

Value supplied for screen name.

minLength: 1 · maxLength: 500

Output

dataobject

Returned data value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "tikhub.user-posts",
  "input": {
    "screen_name": "elonmusk"
  }
}

Output

{
  "data": {
    "user": {
      "id": "44196397",
      "desc": "https://t.co/ZdBx5WABYx",
      "name": "Elon Musk",
      "status": "active",
      "profile": "elonmusk",
      "rest_id": "44196397",
      "affiliates": {
        "label": {
          "url": {
            "url": "https://twitter.com/X"
          },
          "badge": {
            "url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg"
          },
          "description": "X"
        }
      },
      "created_at": "Tue Jun 02 20:12:29 +0000 2009",
      "media_count": 4717
    },
    "status": "ok",
    "timeline": [
      {
        "text": "RT @poteto: Next week, @mattyp @roshan_s and myself will be speedrunning building a new company using only Grok @Bot on the Grok Bot Galaxy…",
        "views": "610589",
        "author": {
          "rest_id": "44196397"
        },
        "quotes": 0,
        "replies": 0,
        "entities": {
          "user_mentions": [
            {
              "name": "lauren",
              "screen_name": "poteto"
            }
          ]
        },
        "retweets": 244,
        "tweet_id": "2098821446009081945",
        "bookmarks": 0,
        "favorites": 0,
        "retweeted": {
          "id": "2098815981787414978"
        },
        "created_at": "Sat Sep 12 17:10:01 +0000 2026",
        "retweeted_tweet": {
          "text": "Next week, @mattyp @roshan_s and myself will be speedrunning building a new company using only Grok @Bot on the Grok Bot Galaxy livestream! We’ve been given just 3 days to do it, or else we might be turned into pizza 🤪 it will be so fun and I hope to see you on the livestream!\n\nI will have to miss the Cursor Compile conf in London and Amsterdam though. I will instead record an extended version of my talk and make it freely available here. So stay tuned for that post!\n\nhttps://t.co/pkqZ3O6IZw",
          "views": "400719",
          "author": {
            "rest_id": "2832427459"
          },
          "quotes": 38,
          "replies": 229,
          "entities": {
            "user_mentions": [
              {
                "name": "matt palmer",
                "screen_name": "mattyp"
              }
            ]
          },
          "retweets": 244,
          "tweet_id": "2098815981787414978",
          "bookmarks": 503,
          "favorites": 2729,
          "created_at": "Sat Sep 12 16:48:18 +0000 2026"
        }
      }
    ]
  }
}

Errors and limitations

invalid_input: The lookup fields or limits are invalid.example: {"screen_name":"elonmusk"}
upstream_error: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

Use X (Twitter) user's posts by handle or user id with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.