# Twitter/X Community Search

> Twitter/X Community Search is a paid API for AI agents from twitter.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Search public X (Twitter) communities by a text query and return matching community results.

## Facts

- Endpoint: GET https://twitter.use.x402atlas.com/search-communities
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-community-search-12276537
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oE-uK6IJVOOYjKIG8a9U0

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 twitter-x-community-search-12276537
```

Example prompt: Can you search X communities for ones related to 'machine learning' and show me what comes up?

## When to prefer this

Use this endpoint when you need to discover or enumerate public X communities matching a keyword or topic — ideal for community research, brand monitoring, or helping users find groups to join. Prefer this over general tweet search when the goal is to find community spaces rather than individual posts or users.

## Known failure modes

- Empty query string returns a validation error (minLength:1 not met)
- Query exceeding 200 characters is rejected
- No matching communities found returns an empty data array with result_count of 0
- X API rate limits or downtime may cause upstream errors
- Payment failure (x402) prevents the call from being processed

## How this service works

Search public X communities by query.

## Output

Returns a JSON object containing a list of matching public X community objects (with community metadata), a total result count, a query timestamp, and optionally an opaque pagination cursor for retrieving subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1,
       "description": "Community search text"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "data",
      "result_count"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "additionalProperties": true
       }
      },
      "cursor": {
       "type": "string",
       "description": "Opaque cursor for the next page, when supplied by X"
      },
      "queried_at": {
       "type": "string",
       "format": "date-time"
      },
      "result_count": {
       "type": "integer",
       "minimum": 0
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "name": "Technology",
    "rest_id": "1493264213904560130",
    "description": "A community for technology discussions",
    "member_count": 120000
   }
  ],
  "cursor": "NEXT_PAGE_CURSOR",
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-community-search-12276537/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.use.x402atlas.com](https://www.zero.xyz/host/twitter.use.x402atlas.com/llms.txt)