The ranked post preview of a public X (Twitter) community: up to 20 posts with full text, counters, media and author. X serves one page only, so there is no cursor and order is always ranked. A quiet community returns fewer posts or none. Costs 1 credit per successful request.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
Numeric community id, the number in x.com/i/communities/<id>. A full community URL is accepted and the id is extracted from it.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
count
order
cursor
results
pagination
community_id
Common results fields
id
url
lang
text
{
"count": 1,
"order": "ranked",
"cursor": null,
"results": [
{
"id": "2115557010884190648",
"url": "https://x.com/marckohlbrugge/status/2115557010884190648",
"lang": "en",
"text": "My goal for buildinpublic.com is to become the definitive database of all makers and their projects",
"urls": [
{
"url": "https://t.co/YLoSJybAtr",
"display_url": "buildinpublic.com",
"expanded_url": "https://buildinpublic.com"
}
],
"media": [
{
"id": "2115553149566038016",
"url": "https://pbs.twimg.com/media/HVv0YX9XsAAZsE4.jpg",
"type": "photo",
"width": 2560,
"height": 1904
}
],
"author": {
"url": "https://x.com/marckohlbrugge",
"name": "Marc K\u00f6hlbrugge",
"rest_id": "641633",
"verified": true,
"screen_name": "marckohlbrugge"
},
"counters": {
"likes": 369,
"views": 30524,
"quotes": 7,
"replies": 90,
"reposts": 15,
"bookmarks": 246
},
"hashtags": [],
"created_at": "2026-10-28T21:31:11Z",
"created_at_ms": 1793223071000,
"is_note_tweet": true,
"user_mentions": [],
"possibly_sensitive": false
}
],
"pagination": "none",
"community_id": "1493446837214187523"
}
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.