# X Data Gateway — Get Following List

> X Data Gateway — Get Following List is a paid API for AI agents from x-data-gateway.annushka1190.workers.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-16).

Retrieves the list of accounts that a given X/Twitter user is following, identified by numeric user ID

## Facts

- Endpoint: GET https://x-data-gateway.annushka1190.workers.dev/users/following
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x-data-gateway-get-following-list-b65988e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Cf4pD120_3V3jwLhihF01

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 x-data-gateway-get-following-list-b65988e9
```

Example prompt: Pull the list of accounts that X user ID 123456789 is currently following so I can analyze their social graph.

## When to prefer this

Choose this endpoint when you need the following list for a specific X/Twitter user by their numeric ID, especially in agent workflows that require no API key setup and can pay per call in USDC via x402 on Base or Solana. Prefer this over direct Twitter API access when you want a lightweight, pay-as-you-go REST call without OAuth credential management.

## Known failure modes

- Invalid or non-numeric user ID returns an error or empty result
- Private/protected X accounts may not expose following lists
- Rate limiting on the upstream X API may cause temporary failures
- User ID does not exist returns a not-found error
- Missing required `id` query parameter returns a validation error

## How this service works

Live X/Twitter read API plus Base market intel for AI agents: profiles, search, timelines, replies, followers; Base gas, spot prices, token meta/pairs, Base token verdict cards, trending, DefiLlama TVL, wallet intel, x402 probe and text utilities. REST + MCP. Pay per call in USDC via x402 on Base and Solana — no API keys. Free upstream data + local scoring.

## Output

A JSON object with a `data` field containing an array of X user account objects that the specified user is following, including profile metadata such as usernames, display names, and account details as returned by the X 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Numeric X user ID"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-data-gateway-get-following-list-b65988e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x-data-gateway.annushka1190.workers.dev](https://www.zero.xyz/host/x-data-gateway.annushka1190.workers.dev/llms.txt)