Community
GET/v1/twitter/community1 credit
Returns an X Community: name, description, creation date, member count, rules, banner, creator, a sample of members and trending hashtags.
01Query parameters
| Name | Type | Description |
|---|---|---|
| urlrequired | string | The community's URL, e.g. `https://x.com/i/communities/1926186499399139650`. |
02Request
curl "https://api.scrapesocial.ai/v1/twitter/community?url=https%3A%2F%2Fx.com%2Fi%2Fcommunities%2F1926186499399139650" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/twitter/community?url=https%3A%2F%2Fx.com%2Fi%2Fcommunities%2F1926186499399139650
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"__typename": "Community",
"actions": {
"id": "Q29tbXVuaXR5QWN0aW9uczoxOTI2MTg2NDk5Mzk5MTM5NjUw",
"join_action_result": {
"__typename": "CommunityJoinActionUnavailable"
},
"list_members_action_result": {
"__typename": "CommunityListMembersAction"
}
},
"created_at": 1748073622931,
"creator_results": {
"id": "VXNlclJlc3VsdHM6MTkyMTM2ODQ1NDQ0OTIwMTE1Mg==",
"result": {
"__typename": "User",
"core": {
"screen_name": "carsonrmccann"
},
"id": "VXNlcjoxOTIxMzY4NDU0NDQ5MjAxMTUy",
"is_blue_verified": true,
"verification": {
"verified": false
}
}
},
"custom_banner_media": {
"id": "QXBpTWVkaWE6DAATCgABGsjpHX8WQAEAAA==",
"media_info": {
"__typename": "ApiImage",
"color_info": {
"palette": [
{
"percentage": 85.22,
"rgb": {
"blue": 17,
"green": 0,
"red": 217
}
},
{
"percentage": 4.23,
"rgb": {
"blue": 35,
"green": 15,
"red": 32
}
}
]
},
"original_img_height": 500,
"original_img_url": "https://pbs.twimg.com/community_banner_img/1930048753223745537/Ua814CNc?format=jpg&name=orig",
"original_img_width": 1250
}
},
"default_banner_media": {
"id": "QXBpTWVkaWE6DAABCgABFECS7TfVcAcKAAITiFWq8lUQBAAA",
"media_info": {
"__typename": "ApiImage",
"color_info": {
"palette": [
{
"percentage": 36.26,
"rgb": {
"blue": 254,
"green": 88,
"red": 118
}
},
{
"percentage": 24.89,
"rgb": {
"blue": 168,
"green": 101,
"red": 250
}
}
]
},
"original_img_height": 480,
"original_img_url": "https://pbs.twimg.com/media/FECS7TfVcAcCrj2.jpg",
"original_img_width": 1200
}
},
"description": "This community is for creators and builders who are growing to their first 1,000 followers. Give insights, build your brand, and grow a loyal audience.",
"id": "Q29tbXVuaXR5OjE5MjYxODY0OTkzOTkxMzk2NTA=",
"invites_result": {
"__typename": "CommunityInvitesUnavailable"
},
"is_member": false,
"is_nsfw": false,
"join_policy": "Open",
"join_requests_result": {
"__typename": "CommunityJoinRequestsUnavailable"
},
"member_count": 5626,
"members_facepile_results": [
{
"id": "VXNlclJlc3VsdHM6MTkyMTM2ODQ1NDQ0OTIwMTE1Mg==",
"result": {
"__typename": "User",
"avatar": {
"image_url": "https://pbs.twimg.com/profile_images/1963429128402501632/J9C5efvR_normal.jpg"
},
"id": "VXNlcjoxOTIxMzY4NDU0NDQ5MjAxMTUy"
}
},
{
"id": "VXNlclJlc3VsdHM6NDAwNjg4Mjc2MQ==",
"result": {
"__typename": "User",
"avatar": {
"image_url": "https://pbs.twimg.com/profile_images/2011557694264479744/xS6eyqBz_normal.jpg"
},
"id": "VXNlcjo0MDA2ODgyNzYx"
}
}
],
"name": "The First Thousand",
"rest_id": "1926186499399139650",
"role": "NonMember",
"rules": [
{
"description": "This isn’t the space to drop ChatGPT engineered empty platitudes",
"id": "Q29tbXVuaXR5UnVsZToxOTI2MTg5OTYzNzkzNjA5MTg2",
"name": "No Empty Platitudes",
"rest_id": "1926189963793609186"
},
{
"description": "Show how you’re cracking the algorithm",
"id": "Q29tbXVuaXR5UnVsZToxOTI2MTkwMzM5MDE2MDQ4Njg2",
"name": "Post What’s Working",
"rest_id": "1926190339016048686"
}
],
"trending_hashtags_slice": {
"__typename": "CommunityHashtagSlice",
"items": []
}
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
`created_at` is a Unix timestamp in milliseconds. An unknown community is a free 404 (`Community not found`); a URL without `/communities/<id>` is a free 400. Membership fields describe an anonymous visitor (`is_member` false).
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.