# API Direct – Twitter/X User Following List

> API Direct – Twitter/X User Following List is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Retrieves the list of Twitter/X accounts that a specific user follows, with support for paginated bulk fetching.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/twitter/user/following?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-twitter-x-user-following-list-6c81a94f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8csaOdmBQVaIfK8D9fhyJ

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 api-direct-twitter-x-user-following-list-6c81a94f
```

Example prompt: Can you get me the full list of accounts that @naval follows on Twitter? Fetch 3 pages worth so I get a good sample.

## When to prefer this

Use this endpoint when you need to enumerate the accounts a specific Twitter/X user follows — for network analysis, audience research, influencer mapping, or monitoring social graph changes. Prefer this over scraping because it handles pagination automatically and merges results into a single response. Choose this over general Twitter search endpoints when your goal is the following relationship specifically, not tweets or followers.

## Known failure modes

- Username not found — user does not exist or has been suspended
- Private/protected account — following list is not publicly accessible
- Invalid username format — username exceeds 50 characters or is otherwise malformed
- pages parameter out of range — must be between 1 and 175
- Rate limiting or upstream Twitter/X API unavailability causing request failure
- User has zero following — returns empty list rather than an error

## How this service works

Get the accounts that a specific Twitter/X user follows.

## Output

A merged list of Twitter/X user accounts (profiles) that the specified user follows, combining results across the requested number of pages. Each entry typically includes account identifiers, display names, usernames, and profile metadata. Fetching stops early if there are no more results before the requested page count is reached.

## 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": [
      "username"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 175,
       "minimum": 1,
       "description": "Number of pages to fetch and merge into one response (1-175, billed per page). Fetching stops early when there are no more results."
      },
      "username": {
       "type": "string",
       "maxLength": 50,
       "description": "Twitter username without the @ symbol (max 50 characters). A leading @ is accepted and stripped."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-twitter-x-user-following-list-6c81a94f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)