X / Twitter
Followers / Following
Walks the social graph of a public X account and returns each connection with handle, display name, bio snippet, verification flag and follower count. Used for audience overlap analysis, lead sourcing and community mapping.
What you get
Each call returns up to 200 followers, plus a cursor for the next 200.
Endpoint
GET /v1/x/followers-following
Price
$4.50
per 1,000 calls · $0.0045 per call
Cost per call
3 credits
Failed calls never charged
Parameters
The X / Twitter handle, URL or identifier to resolve.
Maximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.
Pagination cursor returned by a previous response.
Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.
One of: true, 1, false, 0
Example request
Live call. Successful calls are charged; failed and empty results are not.
curl "https://fastfetchz.com/v1/x/followers-following?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"Example response
{
"success": true,
"service": {
"platform": "X / Twitter",
"name": "Followers / Following",
"slug": "followers-following"
},
"credits_charged": 3,
"credits_remaining": 97,
"latency_ms": 214,
"data": {
"items": [
{
"id": "1807306582243381248",
"name": "Patrick Lee Cheatham",
"screen_name": "freonfrain21558",
"userName": "freonfrain21558",
"location": "",
"url": null,
"description": "",
"email": null,
"protected": false,
"verified": false,
"followers_count": 1,
"following_count": 20,
"friends_count": 20,
"favourites_count": 0,
"statuses_count": 2,
"media_tweets_count": 1,
"created_at": "Sun Jun 30 06:55:17 +0000 2024",
"profile_banner_url": null,
"profile_image_url_https": "https://pbs.twimg.com/profile_images/1807308515901358080/6_Szhhtp_normal.jpg",
"can_dm": false
},
{
"id": "2075332324867088384",
"name": "Allen Davis",
"screen_name": "AllenDavis6usr",
"userName": "AllenDavis6usr",
"location": "",
"url": null,
"description": "",
"email": null,
"protected": false,
"verified": false,
"followers_count": 2,
"following_count": 18,
"friends_count": 18,
"favourites_count": 3,
"statuses_count": 0,
"media_tweets_count": 0,
"created_at": "Thu Jul 09 21:34:28 +0000 2026",
"profile_banner_url": null,
"profile_image_url_https": "https://abs.twimg.com/sticky/default_profile_images/default_profile_normal.png",
"can_dm": false
}
],
"result_key": "followers",
"has_next_page": true,
"next_cursor": "1875792909221006969",
"status": "success",
"msg": "success",
"code": 0
}
}Getting more results
Each response includes a cursor. Pass it back as cursor to fetch the next 200 followers. Repeat until no cursor is returned.
# Call 1 — first 200 followers
curl "https://fastfetchz.com/v1/x/followers-following?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"
# -> { "data": { ... }, "cursor": "eyJwYWdlIjoyfQ" }
# Call 2 — next 200 followers
curl "https://fastfetchz.com/v1/x/followers-following?target=nasa&cursor=eyJwYWdlIjoyfQ" \
-H "X-API-Key: $FASTFETCHZ_KEY"Limits
- Maximum per call: 200 followers.
- Minimum per call: 1 follower — a target with less data returns fewer followers, and an empty result is still a successful call.
- Each call fetches a full page of up to 200 and costs the same either way. Pass limit to receive fewer than that in the response.
- Larger jobs are paginated with a cursor; there is no cap on how many pages you fetch.
What this costs in practice
2,000,000 followers = 10,000 calls × 3 credits per call = 30,000 credits = $0.00
Priced at the Custom pack rate: 1,000,000 credits for $0.00.
Open in the pricing calculator