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

Twitter/X Community Tweets API

List recent posts from a Twitter/X Community — text, author, engagement, and media.

~18 credits (0.7/result) per request
Try in PlaygroundGet your API key — freeRead the docs
TL;DR
List recent posts from a Twitter/X Community — text, author, engagement, and media. The Twitter/X Community Tweets API (Twitter / X) is a single authenticated GET request to /v1/twitter/community-tweets that responds with clean JSON and costs ~18 credits (0.7/result). Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.

What is the Twitter/X Community Tweets API?

Pass a Community URL or ID and get recent posts as clean JSON. Each result includes tweet text, author, engagement, and media when present. Billed per result — about 0.7 credits each.

What you get

  • Bulk list of community tweets with metadata
  • Dates, URLs, and engagement fields when available
  • Configurable result limit
  • Ideal for monitoring and content pipelines

Try it

Open in Playground

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

Parameters

Sign in to run live
curl "https://api.captapi.com/v1/twitter/community-tweets?url=https%3A%2F%2Fx.com%2FNASA%2Fstatus%2F1816004914774937656" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

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

Example response

{
  "success": true,
  "data": {
    "communityId": "1493446837214187523",
    "totalReturned": 5,
    "tweets": [
      {
        "platform": "twitter",
        "url": "https://x.com/NickDevFE/status/2080189136917672064",
        "id": "2080189136917672064",
        "text": "img2threejs v1.3 is now available. 🎋\n\nOne photo → procedural Three.js code. No meshes. No manual modeling.\n\nGitHub: https://t.co/eYHfZST8DC\n\nv1.3 brings major improvements to geometry reconstruction, material generation, validation, and overall output quality.\n\nFor this demo, I https://t.co/6q2xpbwXrj",
        "lang": "en",
        "publishedAt": "Thu Jul 23 07:11:52 +0000 2026",
        "author": {
          "username": "NickDevFE",
          "displayName": "Nick",
          "url": "https://x.com/NickDevFE",
          "followers": 1759,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1972545424990035968/HKjUZtwo_normal.jpg"
        },
        "engagement": {
          "views": 683643,
          "likes": 3654,
          "replies": 96,
          "retweets": 378,
          "quotes": 22,
          "bookmarks": 4401
        },
        "isReply": false,
        "isRetweet": false,
        "media": [
          "https://pbs.twimg.com/amplify_video_thumb/2080188862962532353/img/52EZv7mlg22s98Dw.jpg"
        ]
      },
      {
        "platform": "twitter",
        "url": "https://x.com/FilipPanoski/status/2079929462565568648",
        "id": "2079929462565568648",
        "text": "pov: you built a product people actually want https://t.co/Ruw8RhZhM1",
        "lang": "en",
        "publishedAt": "Wed Jul 22 14:00:01 +0000 2026",
        "author": {
          "username": "FilipPanoski",
          "displayName": "Filip Panoski",
          "url": "https://x.com/FilipPanoski",
          "followers": 3221,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1842181486587297792/Ia5ilmNs_normal.jpg"
        },
        "engagement": {
          "views": 23033,
          "likes": 404,
          "replies": 111,
          "retweets": 1,
          "quotes": 1,
          "bookmarks": 86
        },
        "isReply": false,
        "isRetweet": false,
        "media": [
          "https://pbs.twimg.com/media/HN1k0g1WQAAeouE.jpg"
        ]
      },
      {
        "platform": "twitter",
        "url": "https://x.com/juiceboy_of_abj/status/2079796903055626348",
        "id": "2079796903055626348",
        "text": "Not everything has to be celebrated publicly,  I just hit 5k followers here on x and i never said anything about it.\n\nThat’s maturity!. \nGood morning Techies 🤗 https://t.co/lg4iL25WFl",
        "lang": "en",
        "publishedAt": "Wed Jul 22 05:13:17 +0000 2026",
        "author": {
          "username": "juiceboy_of_abj",
          "displayName": "Elijah 🌊",
          "url": "https://x.com/juiceboy_of_abj",
          "followers": 5059,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/2047368553309798400/e19Qhn0y_normal.jpg"
        },
        "engagement": {
          "views": 19963,
          "likes": 304,
          "replies": 157,
          "retweets": 30,
          "quotes": 1,
          "bookmarks": 3
        },
        "isReply": false,
        "isRetweet": false,
        "media": [
          "https://pbs.twimg.com/media/HNzsQV0WkAEfUow.jpg"
        ]
      },
      {
        "platform": "twitter",
        "url": "https://x.com/NickDevFE/status/2078392573639737713",
        "id": "2078392573639737713",
        "text": "img2threejs - turn one object photo into a code-only procedural Three.js model\n\nOpen-source toolkit that rebuilds the object in a single reference image as procedural Three.js code (no mesh downloads), quality-gated by a render-vs-reference loop - strong for hard-surface objects https://t.co/NtQBLVzMPO",
        "lang": "en",
        "publishedAt": "Sat Jul 18 08:12:58 +0000 2026",
        "author": {
          "username": "NickDevFE",
          "displayName": "Nick",
          "url": "https://x.com/NickDevFE",
          "followers": 1759,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/1972545424990035968/HKjUZtwo_normal.jpg"
        },
        "engagement": {
          "views": 12628,
          "likes": 262,
          "replies": 11,
          "retweets": 18,
          "quotes": 2,
          "bookmarks": 240
        },
        "isReply": false,
        "isRetweet": false,
        "media": [
          "https://pbs.twimg.com/amplify_video_thumb/2078392549635678208/img/z88HQqtAHlpxS9qx.jpg"
        ]
      },
      {
        "platform": "twitter",
        "url": "https://x.com/juiceboy_of_abj/status/2079072002283819465",
        "id": "2079072002283819465",
        "text": "Good morning techie 🧑‍💻 ❤️\nLet’s do more today 💪\n\nDo have a productive day ❤️ https://t.co/bgiXFDUHte",
        "lang": "en",
        "publishedAt": "Mon Jul 20 05:12:47 +0000 2026",
        "author": {
          "username": "juiceboy_of_abj",
          "displayName": "Elijah 🌊",
          "url": "https://x.com/juiceboy_of_abj",
          "followers": 5059,
          "verified": true,
          "profileImage": "https://pbs.twimg.com/profile_images/2047368553309798400/e19Qhn0y_normal.jpg"
        },
        "engagement": {
          "views": 18160,
          "likes": 215,
          "replies": 117,
          "retweets": 31,
          "quotes": 2,
          "bookmarks": 2
        },
        "isReply": false,
        "isRetweet": false,
        "media": [
          "https://pbs.twimg.com/media/HNpY9mkXMAAbgHm.jpg",
          "https://pbs.twimg.com/media/HNpY9jMWEAAR0AG.jpg"
        ]
      }
    ]
  }
}

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.
  • 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.
cachebooleanNoSet true to serve from the 24h response cache. Default false — always fetch fresh data.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs ~18 credits (0.7/result) — billed per result, so the exact amount scales with how many items you request. Pass cache=true for a free 24h cache hit; default is always fresh (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 tweet using one GET request to /v1/twitter/community-tweets. It returns clean JSON — no OAuth or infrastructure setup required.

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

At the default limit this endpoint costs 18 credits (0.7 per result). Billing scales with how many results you request. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. 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, Rumble, Spotify, Kwai, and more. 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 and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for 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