Community object
3 endpoints on 2 platforms return the Community object with the same 8 fields, so code written for one platform reads the others unchanged. A call costs $0.0004 to $0.0020. It is a preview structure and may still change.
A Community is a place people join and post in: a subreddit on Reddit, a community on X (Twitter). It has a name, a description and a count of members in metrics.members.
Its id goes unchanged to the endpoints that get the community and list its posts; on Reddit the ID is the community's name. Its posts come back as Post, and on X its members as Account.
Fields
A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.
ID; pass it unchanged to the endpoints that get the community and list its posts
Name of the community
Link that opens the community
What the community says it is about
The community's icon
Whether it is marked not safe for work
When the community was created
Community counts
Members
Where each number comes from
The same field name does not always mean the same act on every platform. This table says which of the platform's own numbers goes into the field.
idThe community's name: Reddit locates a community by it, and the community posts endpoint takes the sameRedditnameThe community's name, without the r/; the title its moderators wrote is ext.titleRedditmetrics.membersPeople subscribed to the communityRedditWhat a platform cannot give
A platform stands against a field when none of its endpoints gives it.
avatar_urlX (Twitter)meta.unavailable.Endpoints that return Community
The number beside each platform is how many of its endpoints return it.
Example
One item from x.communities.get, as recorded 2026-10-12 21:39 UTC. Names, text, IDs and links are examples; the figures are as recorded.
{
"id": "1880166407908944826",
"name": "Gear talk",
"url": "https://x.com/i/communities/1880166407908944826",
"description": "Photos, trails and too much coffee.",
"nsfw": false,
"created_at": "2022-02-15T04:47:27.000Z",
"metrics": { "members": 268685 }
}