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

Twitter/X Community Tweets API

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

18 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 Community Tweets API (Twitter / X) is a single authenticated GET request to /v1/twitter/community-tweets that responds with clean JSON, costs 18 credits, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.

What is the Twitter/X Community Tweets API?

The Twitter/X Community 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/community-tweets?url=https%3A%2F%2Fx.com%2FNASA%2Fstatus%2F1816004914774937656" \
  -H "Authorization: Bearer capt_live_..."

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

Example response

{
  "success": true,
  "data": {
    "communityId": "1493446837214187523",
    "totalReturned": 3,
    "tweets": [
      {
        "platform": "twitter",
        "url": "https://x.com/zub_ai_r/status/2073102434025521549",
        "id": "2073102434025521549",
        "text": "gpt-5.5 is way better than fable 5 in speed and UX. \n\nWhich one is working better for you gpt-5.5 or fable 5?",
        "lang": "en",
        "publishedAt": "Fri Jul 03 17:51:51 +0000 2026",
        "author": {
          "username": "zub_ai_r",
          "displayName": "Zubair",
          "url": "https://x.com/zub_ai_r",
          "followers": 82,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/2048816927662039040/X5UCkpjd_normal.jpg"
        },
        "engagement": {
          "views": null,
          "likes": 0,
          "replies": 0,
          "retweets": 0,
          "quotes": 0,
          "bookmarks": 0
        },
        "isReply": null,
        "isRetweet": false,
        "hashtags": [],
        "media": []
      },
      {
        "platform": "twitter",
        "url": "https://x.com/UtkarshVerma181/status/2073102322281144582",
        "id": "2073102322281144582",
        "text": "Gud night guys.. signing ✍️ off today. How’s was your day, mine full of chaos office and then late night classes ..🛌",
        "lang": "en",
        "publishedAt": "Fri Jul 03 17:51:24 +0000 2026",
        "author": {
          "username": "UtkarshVerma181",
          "displayName": "Utkarsh Verma",
          "url": "https://x.com/UtkarshVerma181",
          "followers": 346,
          "verified": false,
          "profileImage": "https://pbs.twimg.com/profile_images/2007649156962385920/zNUP9pdb_normal.jpg"
        },
        "engagement": {
          "views": null,
          "likes": 1,
          "replies": 0,
          "retweets": 0,
          "quotes": 0,
          "bookmarks": 0
        },
        "isReply": null,
        "isRetweet": false,
        "hashtags": [],
        "media": []
      },
      {
        "platform": "twitter",
        "url": "https://x.com/ThomasBurkhartB/status/2073102278316233182",
        "id": "2073102278316233182",
        "text": "Why I am still at $40MRR after 8 month\na 🧵",
        "lang": "en",
        "publishedAt": "Fri Jul 03 17:51:14 +0000 2026",
        "author": {
          "username": "ThomasBurkhartB",
          "displayName": "Thomas Burkhart 💙",
          "url": "https://x.com/ThomasBurkhartB",
          "followers": 11545,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/2057862583667888128/D1IF0T6Q_normal.jpg"
        },
        "engagement": {
          "views": null,
          "likes": 1,
          "replies": 1,
          "retweets": 0,
          "quotes": 0,
          "bookmarks": 0
        },
        "isReply": null,
        "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:

Top-level fields

  • communityIdCommunity id. Example: "1493446837214187523".
  • totalReturnedNumber of items returned in this response.

Tweets

Each item in tweets contains:

  • platformPlatform identifier (e.g. youtube, instagram).
  • urlCanonical URL of the item.
  • idStable platform ID for the item.
  • textText content.
  • langLanguage code of the content.
  • publishedAtPublish date (ISO 8601).
  • authorObject with username, displayName, url, followers, verified, profileImage.
  • engagementObject with views, likes, replies, retweets, quotes, bookmarks.
  • isReplyWhether the tweet is a reply.
  • isRetweetWhether the tweet is a retweet.
  • hashtagsHashtags extracted from the text.
  • mediaMedia attached to the item.

Parameters

NameTypeRequiredDescription
urlstringYesX community URL (x.com/i/communities/ID) or community ID. 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 25, max 200). Billed per result.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 18 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_community_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/community-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 Community Tweets API do?+

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

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

Each successful call costs 18 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 Community 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 User Tweets APITwitter/X Search APITwitter/X Community API

Ready to use the Twitter/X Community Tweets API?

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

Get started free