READ API LIVEBuild on /v1 for search, profiles, timelines, audience graph, and tweet context.READ DOCS

Static endpoint reference · Enriched Reads

Twitter followers API endpoint reference

List a user's followers; choose IDs-only graph reads or profiles mode for enriched objects.

This page runs profiles mode

The request explicitly sets mode=profiles and uses the 1 base + 1 per item rule. Use mode=ids for ID objects; its current rule is 1 base + 1 per 50 items. The full endpoint entry shows the family across both read layers.

GET/v1/users/{id}/followersEnriched Reads1 base + 1 per item#

List a user's followers; choose IDs-only graph reads or profiles mode for enriched objects.

curl 'https://api.xfetch.io/v1/users/44196397/followers?mode=profiles' \
  -H "Authorization: Bearer $XFETCH_API_KEY"
NameInTypeRequiredConstraintsDescription
idpathstringrequiredpattern: ^\d+$
next_tokenquerystringoptional
modequerystringoptionaldefault: profiles; enum: ids | profiles
Response
{
  "data": [
    {
      "id": "95092020",
      "username": "jordanbpeterson",
      "name": "Dr Jordan B Peterson",
      "description": "Best-Selling Author | Clinical Psychologist | #1 Education Podcast | Co-founder of @petersonacademy | Order my new book \"We Who Wrestle With God\" here:",
      "created_at": "2009-12-06T23:33:02.000Z",
      "verified": true,
      "protected": false,
      "profile_image_url": "https://pbs.twimg.com/profile_images/1407056014776614923/TKBC60e1_normal.jpg",
      "follower_count": 6180030,
      "following_count": 1653,
      "tweet_count": 51532,
      "media_count": 7370
    }
  ],
  "meta": {
    "request_id": "req_01HXFETCHEXAMPLE",
    "credits": {
      "charged": 2,
      "remaining": 998
    },
    "pagination": {
      "next_token": "tok_2"
    }
  }
}

Context

From endpoint contract to working workflow

The commercial guide explains when to use this read, while this page keeps the request parameters, response example, schema, and code-derived pricing together. Both point back to the full reference index so the endpoint remains part of one documented API surface.

Run this endpoint in the dashboard playground

Sign in with Google to mint a key and open the documented endpoint selection.