# twitr.sh X/Twitter Community Reader

> twitr.sh X/Twitter Community Reader is a paid API for AI agents from twitr.sh, paid per call via x402, $0.0024/call, status unknown (last checked 2026-09-16).

Reads X/Twitter Community data including profile info, member/moderator rosters, community tweets, and keyword search within a community.

## Facts

- Endpoint: POST https://twitr.sh/api/tools/x_communities
- Price: $0.0024/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitr-sh-x-twitter-community-reader-a4a40d54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F6NcOobfRVzGX-QivH3tI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability twitr-sh-x-twitter-community-reader-a4a40d54 -d '<json body>'
```

Example prompt: Pull up the member roster for X/Twitter community ID 1234567890 — I want up to 200 members listed.

## When to prefer this

Use this endpoint when you need to read data scoped specifically to an X/Twitter Community — its profile, its member or moderator list, its internal tweet feed, or keyword results within it. Prefer this over the general tweet search endpoint when you want results confined to a specific community rather than all of Twitter. Choose this over the user timeline endpoint when the focus is on community membership, moderation, or community-curated content rather than individual user activity.

## Known failure modes

- Invalid or non-existent community ID returns an error
- Missing 'resultsLimit' for members/moderators/tweets/search kinds causes a validation error
- Search query missing when kind='search' causes a validation error
- Private or restricted communities may return access-denied errors
- resultsLimit out of range (below 1 or above 10000) triggers schema validation failure

## How this service works

Read an X/Twitter Community: profile info, member and moderator rosters, the community's tweets, or keyword search inside the community. Fixed price for info; billed per item for rosters, tweets, and search.

## Output

Returns structured data about the community depending on the requested kind: profile info (name, description, member count, rules, etc.) for 'info'; paginated list of member profiles for 'members'; list of moderator profiles for 'moderators'; community tweet timeline for 'tweets'; or keyword-matched tweets within the community for 'search'. Rosters and tweets are billed per item returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "search: query within the community."
  },
  "id": {
   "type": "string",
   "description": "Community ID."
  },
  "kind": {
   "enum": [
    "info",
    "members",
    "moderators",
    "tweets",
    "search"
   ],
   "type": "string",
   "description": "What to read."
  },
  "resultsLimit": {
   "type": "integer",
   "maximum": 10000,
   "minimum": 1,
   "description": "Mandatory for members/moderators/tweets/search: max items, billed per item."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "2079908425904042170",
    "name": "Build in Public",
    "description": "Founders sharing progress, metrics, and lessons.",
    "memberCount": 48210
   }
  ],
  "runId": "tw_example",
  "payment": {
   "amount": "0.001200",
   "currency": "USD",
   "protocol": "x402"
  },
  "duration": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitr-sh-x-twitter-community-reader-a4a40d54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitr.sh](https://www.zero.xyz/host/twitr.sh/llms.txt)