Appearance
Community Tweets
GET /v1/twitter/community/tweets
Fetches tweets posted within a Twitter/X Community by URL. Returns an array of tweets, each with id, full_text, view_count, favorite_count, retweet_count, reply_count, bookmark_count, quote_count, created_at, and source. Each tweet includes a user object with the author's name, screen_name, avatar, followers_count, and is_blue_verified status.
Authentication
All requests require the x-api-key header. Get your key at scrapecreators.com.
Query Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
url | string | yes | Community URL | https://x.com/i/communities/1926186499399139650 |
Example Request
curl
bash
curl 'https://api.scrapecreators.com/v1/twitter/community/tweets?url=https://x.com/i/communities/1926186499399139650' \
-H 'x-api-key: $SCRAPECREATORS_API_KEY'Node / TypeScript
js
const params = new URLSearchParams({ url: 'https://x.com/i/communities/1926186499399139650' });
const res = await fetch(`https://api.scrapecreators.com/v1/twitter/community/tweets?${params}`, {
headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);Python
python
import os, requests
r = requests.get(
'https://api.scrapecreators.com/v1/twitter/community/tweets',
headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
params={'url': 'https://x.com/i/communities/1926186499399139650'},
)
r.raise_for_status()
print(r.json())CLI
bash
scrapecreators twitter community-tweets --helpExample Response
json
{
"success": true,
"tweets": [
{
"id": "1940874916771123735",
"source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>",
"view_count": "8660",
"bookmark_count": 10,
"bookmarked": false,
"created_at": "Thu Jul 03 20:46:54 +0000 2025",
"conversation_id_str": "1940874916771123735",
"display_text_range": [
0
],
"favorite_count": 173,
"favorited": false,
"full_text": "You just need 1 viral tweet https://t.co/Z4Q5jtsxAp",
"is_quote_status": false,
"lang": "en",
"possibly_sensitive": false,
"possibly_sensitive_editable": true,
"quote_count": 2,
"reply_count": 55,
"retweet_count": 3,
"retweeted": false,
"user_id_str": "73647967",
"id_str": "1940874916771123735",
"user": {
"__typename": "User",
"id": "VXNlcjo3MzY0Nzk2Nw==",
"rest_id": "73647967",
"affiliates_highlighted_label": {},
"avatar": {
"image_url": "https://pbs.twimg.com/profile_images/1590652776719286274/eeualJ2p_normal.jpg"
},
"core": {
"created_at": "Sat Sep 12 14:00:05 +0000 2009",
"name": "Mike in’ Software",
"screen_name": "mikeinsoftware"
},
"dm_permissions": {},
"is_blue_verified": true,
"legacy": {
"default_profile": true,
"default_profile_image": false,
"description": "Senior SWE👨💻 Indie hacking my way to financial freedom 👀 Follow for free early access to next project",
"entities": {
"description": {
"urls": []
}
},
"fast_followers_count": 0,
"favourites_count": 7532,
"followers_count": 1173,
"friends_count": 990,
"has_custom_timelines": true,
"is_translator": false,
"listed_count": 8,
"media_count": 518,
"normal_followers_count": 1173,
"pinned_tweet_ids_str": [
"1945599110876176561"
],
"possibly_sensitive": false,
"profile_interstitial_type": "",
"statuses_count": 2931,
"translator_type": "none",
"withheld_in_countries": []
},
"location": {
"location": ""
},
"media_permissions": {},
"parody_commentary_fan_label": "None",
"profile_image_shape": "Circle",
"professional": {
"rest_id": "1928057904189559014",
"professional_type": "Creator",
"category": [
{
"id": 1055,
"name": "Software developer/Programmer/Software engineer",
"icon_name": "IconBriefcaseStroke"
}
]
},
"privacy": {
"protected": false
},
"relationship_perspectives": {},
"tipjar_settings": {
"is_enabled": false,
"band
... (truncated)Credits
Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.
Errors
| Status | Meaning | Action |
|---|---|---|
| 200 | Success. | Use the JSON payload. |
| 400 | Invalid or missing parameter. | Verify required parameters and value format. |
| 401 | Missing or invalid x-api-key. | Pass a valid API key in the header. |
| 402 | Out of credits. | Top up at scrapecreators.com or wait for plan reset. |
| 404 | Resource not found or private. | Confirm the handle, URL, or id and that the resource is public. |
| 429 | Rate limited. | Backoff and retry with exponential delay. |
| 500 | Server error or upstream platform failure. | Retry with backoff; report persistent errors to support. |