# twit.sh — Get Twitter/X User Followers

> twit.sh — Get Twitter/X User Followers is a paid API for AI agents from twit.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Retrieves a paginated list of followers for a given Twitter/X user ID, returning profile and metrics data for each follower

## Facts

- Endpoint: GET https://twit.sh/users/followers
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twit-sh-get-twitter-x-user-followers-f5540889
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f_3Vdvj4fBqwG0s5UdcE5

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 twit-sh-get-twitter-x-user-followers-f5540889
```

Example prompt: Pull the followers list for Twitter user ID 783214 — I want to see their usernames, descriptions, and follower counts, and page through all of them.

## When to prefer this

Choose this endpoint when you need real-time Twitter/X follower data without managing Twitter API credentials or OAuth. It is ideal for autonomous AI agents that need to pay per request via USDC on Base (x402 protocol) with no prior sign-up. Prefer it over direct Twitter API access when credential management is undesirable, or when building fully autonomous workflows that self-fund via crypto micropayments.

## Known failure modes

- Invalid or non-numeric user ID returns an error
- User account is private or suspended — no followers returned
- Expired or invalid next_token causes pagination failure
- Rate limits or payment failures (USDC/x402) may block requests
- User has zero followers — empty data array returned

## How this service works

Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.

## Output

Returns a JSON array of follower objects, each containing the follower's numeric ID, display name, username, verified status, bio description, and public metrics (like count, tweet count, followers count, following count). Also includes a meta object with a next_token for paginating to the next page of results.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Numeric Twitter user ID"
      },
      "next_token": {
       "type": "string",
       "description": "Pagination cursor from previous response"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "9253672",
    "name": "Hal Finney",
    "username": "halfin",
    "verified": false,
    "description": "Running bitcoin.",
    "public_metrics": {
     "like_count": 300,
     "tweet_count": 600,
     "followers_count": 134000,
     "following_count": 200
    }
   }
  ],
  "meta": {
   "next_token": "abc123"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twit-sh-get-twitter-x-user-followers-f5540889/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twit.sh](https://www.zero.xyz/host/twit.sh/llms.txt)