# glim.sh Twitter User Followers

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

Retrieves the list of followers for a specified Twitter/X user account

## Facts

- Endpoint: POST https://glim.sh/api/v1/twitter/users/:ref/followers
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glim-sh-twitter-user-followers-ad32b332
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6_AyPOiiKt_l4gliBQlPD

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 glim-sh-twitter-user-followers-ad32b332 -d '<json body>'
```

Example prompt: Can you pull the full list of followers for the Twitter account @elonmusk using glim.sh?

## When to prefer this

Use this endpoint when you need to programmatically retrieve the follower list for a specific Twitter/X user and are operating in an x402-enabled agent environment. Prefer this over scraping or manual lookup when you need structured follower data as part of an automated workflow, social graph analysis, or audience research task. The sibling endpoint 'Verified followers only' should be preferred if you specifically need blue-check followers.

## Known failure modes

- User reference not found — invalid handle or ID returns a 404 or empty result
- Rate limit exceeded — too many requests in a short window
- Payment failure — x402 payment not accepted or insufficient USDC balance
- Private/protected account — followers not publicly accessible, returns error or empty list
- Malformed user reference — missing or badly formatted :ref parameter causes a 400 error

## How this service works

User followers

## Output

A list of Twitter/X user accounts that follow the specified user, including profile details such as usernames, display names, and possibly follower counts or other user metadata returned by the API.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "cursor": {
       "type": "string",
       "description": "Pagination cursor"
      },
      "page_size": {
       "type": "integer",
       "default": 200,
       "maximum": 200,
       "minimum": 20,
       "description": "Number of users per page"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "propertyNames": {
         "type": "string"
        },
        "additionalProperties": {}
       }
      },
      "meta": {
       "type": "object",
       "required": [
        "result_count"
       ],
       "properties": {
        "next_cursor": {
         "type": "string"
        },
        "result_count": {
         "type": "integer",
         "maximum": 9007199254740991,
         "minimum": -9007199254740991
        },
        "has_next_page": {
         "type": "boolean"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

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