X / Twitter Following API
List the accounts a public X (Twitter) account follows by username with cursor pagination. Limit is a per-page maximum; follow the response's nextCursor for more.
$0.45/1k req, pay per request, no subscription.
{"username": "NASAJPL","name": "NASA JPL","bio": "Exploring the solar system and beyond via robotic missions.","followers": 2840000,"following": 412,"location": "Pasadena, CA","avatarUrl": "https://pbs.twimg.com/profile_images/1758000010000000000/nasajpl.jpg","id": "16952242",... 2 more fields}
Pricing and providers
X / Twitter Following API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get X / Twitter following in one request
This sample shows 14 of 15 fields. See every field
{
"found": true,
"data": {
"items": [
{
"username": "NASAJPL",
"name": "NASA JPL",
"bio": "Exploring the solar system and beyond via robotic missions.",
"followers": 2840000,
"following": 412,
"location": "Pasadena, CA",
"avatarUrl": "https://pbs.twimg.com/profile_images/1758000010000000000/nasajpl.jpg",
"id": "16952242",
"createdUtc": 1224633600,
"posts": 18900
},
{
"username": "Space_Station",
"name": "International Space Station",
"bio": "Orbiting Earth at 17,500 mph. Home to astronauts from around the world.",
"followers": 5120000,
"following": 198,
"location": "Low Earth Orbit",
"avatarUrl": "https://pbs.twimg.com/profile_images/1758000011000000000/iss.jpg",
"id": "1451773004",
"createdUtc": 1369180800,
"posts": 9400
},
{
"username": "NOAA",
"name": "NOAA",
"bio": "Science, service, and stewardship for weather, climate, and oceans.",
"followers": 942000,
"following": 503,
"location": "Washington, DC",
"avatarUrl": "https://pbs.twimg.com/profile_images/1758000012000000000/noaa.jpg",
"id": "14342564",
"createdUtc": 1207699200,
"posts": 41200
}
],
"nextCursor": "DAABCgABGZ5xyzABC9876ZZ"
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- usernamestring
nasa
The X (Twitter) username to fetch the following list for, without the @ prefix (e.g. elonmusk).
- cursorstring
Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of followed accounts.
- limitinteger
200
Accepted but does not change the page: every call returns one full native page of followed accounts (about 50), never trimmed, so follow nextCursor to continue exactly where this response ended.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `location`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a profile that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted.
Response
JSON, one example value per field.
Followed-account records, normalized to a compact shape. Populated whenever the provider has data for the entity.
- avatarUrlstring
https://pbs.twimg.com/profile_images/1758000010000000000/nasajpl.jpg
URL of the account's profile image (may be empty). Populated whenever the provider has data for the entity.
- biostring
Exploring the solar system and beyond via robotic missions.
The account's profile bio/description.
- createdUtcnumber
1224633600
UTC epoch timestamp in seconds (Unix time) the account was created. Multiply by 1000 for a JS Date in milliseconds.
- followersinteger
2840000
How many followers this account has.
- followinginteger
412
How many accounts this account follows.
- idstring
16952242
Numeric X user id of the account, as a string.
- locationstringcan require
Pasadena, CA
The account's self-reported location (may be empty).
- namestring
NASA JPL
The account's display name. Populated whenever the provider has data for the entity.
- postsinteger
18900
Number of posts the account has published.
- usernamestring
NASAJPL
The account's @ handle, without the @ prefix. Populated whenever the provider has data for the entity.
- nextCursorstring
DAABCgABGZ5xyzABC9876ZZ
Opaque cursor for the next page of followed accounts, or null when there are no more. Pass it back as cursor to continue.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the X / Twitter Following API
The AnyAPI X / Twitter Following API returns X / Twitter following data as normalized JSON from one POST call to /v1/run/twitter.following. List the accounts a public X (Twitter) account follows by username with cursor pagination. Limit is a per-page maximum; follow the response's nextCursor for more. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $0.45 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of X / Twitter following calls through AnyAPI succeeded, with a median response time of 1.7 seconds across 43,291 measured calls.
