> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Community tweets > Fetches the tweet timeline of a public X Community (`x.com/i/communities/`). Each tweet is fully shaped WITH its author (community tweets come from many members). Returns the most recent tweets (one page, no pagination). **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). ```text Prompt I want to make an API call to /v1/twitter/community/tweets. Here are the details: Endpoint: GET https://api.scraperize.com/v1/twitter/community/tweets Description: Fetches the tweet timeline of a public X Community (`x.com/i/communities/`). Each tweet is fully shaped WITH its author (community tweets come from many members). Returns the most recent tweets (one page, no pagination). Required Headers: - x-api-key: Your API key Parameters: - url (string) [required]: Community URL, e.g. https://x.com/i/communities/1433869915434278912 - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. Example Response: { "data": { "communityId": "1433869915434278912", "tweets": [ { "id": "2096516206916431943", "url": "https://x.com/Xbdguangfang/status/2096516206916431943", "text": "有人能告诉我现在还能修改社群信息或者创建社群吗，感谢🙏", "isLongForm": false, "lang": "zh", "createdAtMs": 1788683389000, "createdAt": "2026-09-06T08:29:49.000Z", "counts": { "likes": 25, "retweets": 3, "replies": 2, "quotes": 0, "bookmarks": 1 }, "views": "14005", "author": { "id": "1965139342780993536", "name": "Xbd官方", "screenName": "Xbdguangfang", "url": "https://x.com/Xbdguangfang", "bio": null, "avatarUrl": "https://pbs.twimg.com/profile_images/2101661962543443968/i0NzjJ5i_normal.jpg", "avatarUrlHd": "https://pbs.twimg.com/profile_images/2101661962543443968/i0NzjJ5i_400x400.jpg", "followers": 32, "following": 68, "tweetCount": 4, "verified": false, "protected": false, "profileImageShape": "Circle", "professionalCategory": null }, "media": [], "mentions": [], "urls": [], "hashtags": [], "cashtags": [], "card": null, "communityNote": null, "article": null, "isReply": false, "replyToTweetId": null, "replyToUserId": null, "isQuote": false, "quotedTweetId": null, "quotedTweet": null, "conversationControl": null, "editTweetIds": [ "2096516206916431943" ], "place": null } ], "tweetCount": 12, "fetchedAt": "2026-10-05T14:42:34.905Z" }, "meta": { "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", "creditsCharged": 1, "creditsRemaining": 4999, "cached": false } } Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/twitter/community/tweets openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints paths: /v1/twitter/community/tweets: get: tags: - Twitter summary: Community tweets description: >- Fetches the tweet timeline of a public X Community (`x.com/i/communities/`). Each tweet is fully shaped WITH its author (community tweets come from many members). Returns the most recent tweets (one page, no pagination). parameters: - name: url in: query required: true description: Community URL, e.g. https://x.com/i/communities/1433869915434278912 schema: type: string example: https://x.com/i/communities/1433869915434278912 - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The community's tweets. content: application/json: schema: type: object properties: data: type: object properties: communityId: type: string nullable: true tweets: type: array items: type: object tweetCount: type: integer fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: communityId: '1433869915434278912' tweets: - id: '2096516206916431943' url: https://x.com/Xbdguangfang/status/2096516206916431943 text: 有人能告诉我现在还能修改社群信息或者创建社群吗，感谢🙏 isLongForm: false lang: zh createdAtMs: 1788683389000 createdAt: '2026-09-06T08:29:49.000Z' counts: likes: 25 retweets: 3 replies: 2 quotes: 0 bookmarks: 1 views: '14005' author: id: '1965139342780993536' name: Xbd官方 screenName: Xbdguangfang url: https://x.com/Xbdguangfang bio: null avatarUrl: >- https://pbs.twimg.com/profile_images/2101661962543443968/i0NzjJ5i_normal.jpg avatarUrlHd: >- https://pbs.twimg.com/profile_images/2101661962543443968/i0NzjJ5i_400x400.jpg followers: 32 following: 68 tweetCount: 4 verified: false protected: false profileImageShape: Circle professionalCategory: null media: [] mentions: [] urls: [] hashtags: [] cashtags: [] card: null communityNote: null article: null isReply: false replyToTweetId: null replyToUserId: null isQuote: false quotedTweetId: null quotedTweet: null conversationControl: null editTweetIds: - '2096516206916431943' place: null - id: '2100306796397342942' url: https://x.com/MarketWavz/status/2100306796397342942 text: >- Feature request: give communities their own reputation system. Communities become much more valuable when the people consistently adding value become easier to recognize. I’d love Community-specific reputation: • Helpful votes on replies and posts • “Top Contributor” badges per Community • Reputation based on value, not follower count • Weekly/monthly contributor leaderboards • Community expertise shown on profiles • Higher visibility for consistently useful contributors Someone could have 500 followers on X but be one of the most knowledgeable people inside a 200,000-member investing Community. That should mean something. It would give people a reason to contribute more, help niche experts stand out, and make reputation inside a Community actually valuable. isLongForm: true lang: en createdAtMs: 1789587136000 createdAt: '2026-09-16T19:32:16.000Z' counts: likes: 24 retweets: 2 replies: 2 quotes: 0 bookmarks: 1 views: '11157' author: id: '2099446415734808580' name: MarketWavz screenName: MarketWavz url: https://x.com/MarketWavz bio: null avatarUrl: >- https://pbs.twimg.com/profile_images/2099447612571058176/ukP47PDW_normal.jpg avatarUrlHd: >- https://pbs.twimg.com/profile_images/2099447612571058176/ukP47PDW_400x400.jpg followers: 31 following: 42 tweetCount: 478 verified: true protected: false profileImageShape: Circle professionalCategory: null media: [] mentions: [] urls: [] hashtags: [] cashtags: [] card: null communityNote: null article: null isReply: false replyToTweetId: null replyToUserId: null isQuote: false quotedTweetId: null quotedTweet: null conversationControl: null editTweetIds: - '2100306796397342942' place: null - id: '2099108651608780898' url: https://x.com/anthsadvocacy/status/2099108651608780898 text: >- Hi @HiCommunities and @Support - ALL the X SPACES that are hosted within all X Communities have disappeared, and also, one is unable to host a space in an X Community. This bug seems to have appeared in the first half of September 2026 . Are you @HiCommunities and @Support currently deleting or updating communities in the background? I hope those spaces can be restored, or at least please allow us to make archive backups (before you delete all spaces), because that feature (archive) is not working either. isLongForm: true lang: en createdAtMs: 1789301476000 createdAt: '2026-09-13T12:11:16.000Z' counts: likes: 17 retweets: 1 replies: 2 quotes: 0 bookmarks: 1 views: '10130' author: id: '1995536935562215425' name: Advocate screenName: anthsadvocacy url: https://x.com/anthsadvocacy bio: null avatarUrl: >- https://pbs.twimg.com/profile_images/1995547326530686976/_-8hFDMv_normal.jpg avatarUrlHd: >- https://pbs.twimg.com/profile_images/1995547326530686976/_-8hFDMv_400x400.jpg followers: 29 following: 33 tweetCount: 47 verified: false protected: false profileImageShape: Circle professionalCategory: null media: [] mentions: - screenName: HiCommunities id: '1433894099178774532' indices: - 3 - 17 - screenName: Support id: '17874544' indices: - 22 - 30 - screenName: HiCommunities id: '1433894099178774532' indices: - 246 - 260 urls: [] hashtags: [] cashtags: [] card: null communityNote: null article: null isReply: false replyToTweetId: null replyToUserId: null isQuote: false quotedTweetId: null quotedTweet: null conversationControl: null editTweetIds: - '2099108651608780898' place: null tweetCount: 12 fetchedAt: '2026-10-05T14:42:34.905Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Community not found / suspended. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.