CaptapiCaptapi
Twitter / X
GET /v1/twitter/user-tweets

Twitter/X User Tweets API

Bulk-list Twitter / X content with full metadata for each item.

14 credits per request (0.7 per result)
Get your API key — freeRead the docs
TL;DR
Bulk-list Twitter / X content with full metadata for each item. The Twitter/X User Tweets API (Twitter / X) is a single authenticated GET request to /v1/twitter/user-tweets that responds with clean JSON, costs 14 credits, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.

What is the Twitter/X User Tweets API?

The Twitter/X User Tweets API lets you list items in bulk with metadata from Twitter / X with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.

What you get

  • Bulk list of items with full metadata
  • View counts, dates, and direct URLs
  • Configurable result limit
  • Ideal for monitoring and content pipelines

Try it

Fill in the parameters below and copy a ready-to-run request in your language of choice.

Parameters

curl "https://api.captapi.com/v1/twitter/user-tweets?url=https%3A%2F%2Fx.com%2FNASA" \
  -H "Authorization: Bearer capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "data": {
    "handle": "nasa",
    "totalReturned": 5,
    "tweets": [
      {
        "platform": "twitter",
        "url": "https://x.com/NASA/status/2073078061499617543",
        "id": "2073078061499617543",
        "text": "Happy 250th, America! 🇺🇸\n\nRed (Mars), white (Moon), and blue (Earth) brought to you by the solar system. https://t.co/ggjzhkO596",
        "lang": "en",
        "publishedAt": "Fri Jul 03 16:15:00 +0000 2026",
        "author": {
          "username": "NASA",
          "displayName": "NASA",
          "url": "https://x.com/NASA",
          "followers": 92152455,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"
        },
        "engagement": {
          "views": 234393,
          "likes": 3954,
          "replies": 237,
          "retweets": 678,
          "quotes": 38,
          "bookmarks": 171
        },
        "isReply": false,
        "isRetweet": false,
        "hashtags": [],
        "media": [
          "https://pbs.twimg.com/media/HMQs7G_X0AA523_.jpg",
          "https://pbs.twimg.com/media/HMQs7YSW0AA5xkZ.jpg",
          "https://pbs.twimg.com/media/HMQs72tXsAAbFWb.jpg"
        ]
      },
      {
        "platform": "twitter",
        "url": "https://x.com/NASA/status/2073093132984479786",
        "id": "2073093132984479786",
        "text": "RT @NASAArmstrong: In honor of @Freedom250, two of our most iconic aircraft are getting a fresh coat of red, white, and blue! ✈️🇺🇸\n\nNASA Ar…",
        "lang": "en",
        "publishedAt": "Fri Jul 03 17:14:53 +0000 2026",
        "author": {
          "username": "NASA",
          "displayName": "NASA",
          "url": "https://x.com/NASA",
          "followers": 92152455,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"
        },
        "engagement": {
          "views": 126668,
          "likes": 2689,
          "replies": 64,
          "retweets": 415,
          "quotes": 37,
          "bookmarks": 166
        },
        "isReply": false,
        "isRetweet": true,
        "hashtags": [],
        "media": []
      },
      {
        "platform": "twitter",
        "url": "https://x.com/NASA/status/2073074361339150663",
        "id": "2073074361339150663",
        "text": "RT @NASASpox: On America’s 250th birthday, @NASA is helping write the next chapter of exploration 🇺🇸\n\n🌕 New Moon Base missions announced\n🤝…",
        "lang": "en",
        "publishedAt": "Fri Jul 03 16:00:18 +0000 2026",
        "author": {
          "username": "NASA",
          "displayName": "NASA",
          "url": "https://x.com/NASA",
          "followers": 92152455,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"
        },
        "engagement": {
          "views": 76908,
          "likes": 278,
          "replies": 29,
          "retweets": 37,
          "quotes": 3,
          "bookmarks": 12
        },
        "isReply": false,
        "isRetweet": true,
        "hashtags": [],
        "media": []
      },
      {
        "platform": "twitter",
        "url": "https://x.com/NASA/status/2072697624101105737",
        "id": "2072697624101105737",
        "text": "There will be more than just fireworks to see in the night sky this month!\n\nYou can look forward to these celestial sights in July:\n- A lunar-planetary alignment\n- A visiting comet\n- A good look at Saturn and the Milky Way\n\nHappy skywatching! https://t.co/6EP5GpvAQw https://t.co/y0O5qsNf1j",
        "lang": "en",
        "publishedAt": "Thu Jul 02 15:03:17 +0000 2026",
        "author": {
          "username": "NASA",
          "displayName": "NASA",
          "url": "https://x.com/NASA",
          "followers": 92152455,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"
        },
        "engagement": {
          "views": 504063,
          "likes": 4069,
          "replies": 140,
          "retweets": 839,
          "quotes": 46,
          "bookmarks": 335
        },
        "isReply": false,
        "isRetweet": false,
        "hashtags": [],
        "media": [
          "https://pbs.twimg.com/media/HMOzgOzX0AAhkJy.jpg"
        ]
      },
      {
        "platform": "twitter",
        "url": "https://x.com/NASA/status/2072395277219016738",
        "id": "2072395277219016738",
        "text": "When Artemis II flew around the Moon, it carried a small piece of the Wright Flyer with it.\n\nNow, the swatch is back home at @airandspace. Learn more about the mementos that Artemis II carried: https://t.co/mfOGjlmj5O",
        "lang": "en",
        "publishedAt": "Wed Jul 01 19:01:51 +0000 2026",
        "author": {
          "username": "NASA",
          "displayName": "NASA",
          "url": "https://x.com/NASA",
          "followers": 92152455,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"
        },
        "engagement": {
          "views": 581191,
          "likes": 2170,
          "replies": 97,
          "retweets": 312,
          "quotes": 11,
          "bookmarks": 72
        },
        "isReply": false,
        "isRetweet": false,
        "hashtags": [],
        "media": []
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Result

  • totalNumber of items returned.

Each item

Each item in items contains:

  • titleItem title.
  • urlDirect URL to the content.
  • viewsView count.
  • publishedAtPublish date (ISO 8601).

Parameters

NameTypeRequiredDescription
urlstringYesTwitter/X profile URL or @handle. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
limitintegerNoMax items to return (default 20, max 200). Billed per result.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 14 credits — billed per result, so the exact amount scales with how many items you request. Repeat calls for the same request are served from cache for free (metrics refresh within ~1 hour).

Using an AI agent? This endpoint is the MCP tool twitter_user_tweets via @captapi/mcp. Set it up →

How it works

  1. 1. Sign up — get 100 free credits, no card required.
  2. 2. Create a key from your dashboard.
  3. 3. Send one request to /v1/twitter/user-tweets and parse the JSON response.

Use cases

Content Pipelines

Ingest a channel's catalog in bulk.

Monitoring

Detect new uploads automatically.

Archiving

Snapshot a creator's full library.

Analytics

Aggregate performance across many videos.

Frequently asked questions

What does the Twitter/X User Tweets API do?+

The Twitter/X User Tweets API lets you list items in bulk with metadata from a public Twitter / X video using one GET request to /v1/twitter/user-tweets. It returns clean JSON — no OAuth or scraping setup required.

How many credits does the Twitter/X User Tweets API cost?+

Each successful call costs 14 credits. Responses are cached for 24 hours, and cached results cost 0 credits. Failed or empty results are never charged.

Do I need a Twitter / X API key or OAuth?+

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, and Rumble. We handle proxies, rate limits, retries, and authentication for you.

Is the Twitter/X User Tweets API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.

More Twitter / X APIs

Twitter/X Tweet Details APITwitter/X Transcript APITwitter/X Profile APITwitter/X Search APITwitter/X Community APITwitter/X Community Tweets API

Ready to use the Twitter/X User Tweets API?

Sign up, grab your key, and make your first call in 60 seconds.

Get started free