SocialToAIStart freeConsole
POST/v1/call/x.communityPreview

X (Twitter) community profile API

Only on X.

The X (Twitter) community profile API returns an X community by its ID: name, description, members, moderators, how people join, when it was created. One call costs 1 credit ($0.002 to $0.0033 depending on the pack); failed calls are free. Call it over HTTP or from your AI client over MCP. Last tested 2026-10-17.

Start for freeSign in to run
100 credits on sign-up, no card needed
1 creditper call
One objectreturned per call
2026-10-17last tested
753 Bsample response, 1 item

Last updated:

Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

Request and response

curl https://api.socialtoai.com/v1/call/x.community \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "id": "1493446837214187523"  }'
import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/call/x.community",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "id": "1493446837214187523",    },)print(response.json())
# Connected over MCP? Ask in plain words.Use the X community profile interface (x.community) with id: 1493446837214187523.# Your AI calls the call tool with:{  "id": "1493446837214187523"}
Sign in to run1 creditOpens in the Playground with these parameters after you sign in. It never runs by itself.
200 OK753 B1 credit
{  "op": "x.community",  "platform": "x",  "status": "ok",  "items": [    {      "platform": "x",      "id": "…",      "ref": "…",      "approx": [],      "type": "entry",      "entry_type": "community",      "title": "…",      "url": "https://example.com/…",      "rank": null,      "heat": null,      "fields": {        "description": "…",        "nsfw": false,        "created_at": "2022-02-15T04:47:27.000Z",        "members": 268685      }    }  ],  "unavailable": [],  "cost_credits": 1}
entry_type
community
description
…
nsfw
false
created_at
2022-02-15T04:47:27.000Z
members
268685

Names and text were removed from the sample; the numbers are as recorded.

Sample dataFull response

1 parameter.
All required.

Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.

NameTypeRequiredDefaultDescription
idstringRequired—Community ID, a string of digits

Where to get what you send.

id

Community ID, a string of digits (e.g. 1493446837214187523)

No other interface of the platform returns it: take it from the web page or link as described above.

The fields of each item.
What X cannot give is marked.

FieldTypeMeaning
items[].titlestringThe entry's title or name.
items[].urlstringA link that opens it; null where the platform's list has none.
items[].rankintegerPosition on a board, from 1.
items[].heatintegerThe platform's heat score.
items[].fields.descriptionstringThe community's description.
items[].fields.nsfwbooleanWhether it is marked as adult content.
items[].fields.created_atstringWhen it was created, ISO 8601 in UTC.
items[].fields.membersintegerMember count.
nullFields X cannot give

X gives every field of this call. Where one item lacks a value, that field is null.

Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. Response format

What to expect.

One call returns one object, with no pages, for 1 credit.

1 call per second per key, 5 after a purchase; going over is not charged. Rate limits

A failed call costs 0 credits and is never retried on its own. Error codes

Once connected over MCP, these questions use it.

  1. Get an X community by its ID: 1493446837214187523.
    call {"op":"x.community","id":"1493446837214187523"}
    1 credit

Questions.
Short answers.

Everything on X
Do I need a X account or X's own API access?
No. You only need a SocialToAI key. The call returns content and account information publicly visible on X; you never sign in to X or apply for anything there.
What does “Preview” mean here?
Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

Your AI is one URL away
from all of social media.

Start for freeDocs

100 credits on sign-up, no card needed