FastFetchz
X

X / Twitter

Followers / Following

per_call

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.

Endpoint

GET /v1/x/followers-following

Price

$0.30

per 1,000 calls · $0.0003 per call

Cost per call

0.2 credits

Failed calls never charged

Parameters

target
required
string

The X / Twitter handle, URL or identifier to resolve.

limit
optional
integer

Items to return for list responses. Default 10, max 100.

cursor
optional
string

Pagination cursor returned by a previous response.

Example request

Sandbox calls return deterministic sample data in the live payload shape.

curl
curl "https://api.fastfetchz.com/v1/x/followers-following?target=nasa" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "X / Twitter",
    "name": "Followers / Following",
    "slug": "followers-following"
  },
  "credits_charged": 0.2,
  "credits_remaining": 99.8,
  "latency_ms": 214,
  "data": {
    "users": [
      {
        "id": "2000175946",
        "username": "follower_75947",
        "full_name": "Sample Follower 1",
        "verified": false,
        "follower_count": 85946
      },
      {
        "id": "2000153565",
        "username": "follower_53566",
        "full_name": "Sample Follower 2",
        "verified": false,
        "follower_count": 63565
      }
    ],
    "paging": {
      "has_more": true,
      "next_cursor": "cursor_2"
    }
  }
}

Error codes

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedThe key exceeded its monthly cap or the burst limit. Retry later.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.