X (TWITTER) API

Twitter User Tweets API

List the tweets an X account has posted, using its numeric user ID from the user profile endpoint. Each tweet includes the text, timestamp, media and like, retweet, reply and view counts. Load older tweets with `cursor`.

Endpoint
POST /x/get-user-tweets
Price
1 credit per result
SDK
client.x.getUserTweets()
MCP tool
x_get_user_tweets
Start free with 100 creditsRead docs →
Terminal
curl -X POST "https://api.bridgly.app/x/get-user-tweets" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "userId": "44196397"
}'
[ REQUEST AND RESPONSE ]

What does the Twitter User Tweets API return?

Twitter timeline API: list any X (Twitter) account’s tweets, newest first, with text, media, links and like, retweet, reply and view counts, as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

userIdstringrequired
Numeric user ID (rest_id) whose tweets to list, e.g. "44196397". Look it up from a handle with get-user.
cursorstring
The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json
{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "tweets": [
      {
        "id": "string",
        "url": "string",
        "text": "string",
        "author": {
          "userId": "string",
          "username": "string",
          "profileUrl": "string",
          "displayName": "string",
          "bio": "string",
          "avatarUrl": "string",
          "bannerUrl": "string",
          "location": "string",
          "followerCount": 0,
          "followingCount": 0,
          "tweetCount": 0,
          "mediaCount": 0,
          "likeCount": 0,
          "listedCount": 0,
          "pinnedTweetId": "string",
          "pinnedTweetUrl": "string",
          "createdAt": "2026-01-15T09:30:00.000Z",
          "createdAtEpochMs": 0,
          "isVerified": true,
          "isBlueVerified": true
        },
        "createdAt": "2026-01-15T09:30:00.000Z",
        "createdAtEpochMs": 0,
        "source": "string",
        "conversationId": "string",
        "replyCount": 0,
        "retweetCount": 0,
        "likeCount": 0,
        "quoteCount": 0,
        "bookmarkCount": 0,
        "viewCount": 0,
        "replyToTweetId": "string",
        "replyToUserId": "string",
        "replyToUsername": "string",
        "replyToTweetUrl": "string",
        "isQuote": true,
        "quotedTweetId": "string",
        "quotedTweetUrl": "string",
        "quotedTweetAuthorId": "string",
        "quotedTweetAuthorUsername": "string",
        "retweetedTweetId": "string",
        "retweetedTweetUrl": "string",
        "retweetedTweetAuthorId": "string",
        "retweetedTweetAuthorUsername": "string",
        "lang": "string",
        "isSensitive": true,
        "hashtags": [
          "string"
        ],
        "mentions": [
          {
            "userId": "string",
            "username": "string",
            "displayName": "string",
            "profileUrl": "string"
          }
        ],
        "urls": [
          {
            "shortUrl": "string",
            "expandedUrl": "string",
            "displayUrl": "string"
          }
        ],
        "media": [
          {
            "type": "photo",
            "url": "string",
            "mediaKey": "string",
            "mediaId": "string",
            "width": 0,
            "height": 0,
            "expandedUrl": "string",
            "videoUrl": "string",
            "durationMs": 0
          }
        ]
      }
    ]
  }
}
[ USE CASES ]

What can you build with the Twitter User Tweets API?

Monitor accounts

Pull new tweets from founders, competitors or news accounts on a schedule.

Analyze engagement

Compare likes and views across an account’s recent tweets.

Feed a model

Summarize what an account has been tweeting about this week.

[ FAQ ]

Twitter User Tweets API questions

How do I get a Twitter user’s tweets with an API?

Get the account’s numeric user ID from the Twitter User API and send it as userId. Each call returns a page of about 20 tweets; send the nextCursor from the response to page back through older ones.

Can I export an account’s tweets for analysis?

Yes. Page through the timeline and store each tweet’s text, time and engagement counts. You pay 1 credit per tweet returned.

How do I get the replies an account posts?

Use the Twitter Replies API, which lists the replies an account has posted to other tweets.

How do I get all of a user’s tweets?

Each call returns about 20 tweets and a nextCursor. Send it back as cursor to get the next page; it is null once the timeline runs out.

How do I use the Twitter User Tweets API?

Send a POST request to https://api.bridgly.app/x/get-user-tweets with userId in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.x.getUserTweets(). AI agents connected to Bridgly over MCP can call the x_get_user_tweets tool.

How much does the Twitter User Tweets API cost?

Costs 1 credit per result returned, with a minimum of 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More X (Twitter) endpoints

The same API key works on every endpoint. See all X (Twitter) API endpoints.

Try the Twitter User Tweets API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI
free credits

On business email signup. No credit card required.

Start free with 100 credits
Book a demoRead the docs