GET /api/v1/x/users/{id}/followers

Users

Changed on Oct 20, 2026

Returns public follower profiles for the selected user, newest first. x.com puts some promoted followers first. Xquik doesn't.

get/api/v1/x/users/{id}/followers

Request

Base URL: https://xquik.com
URL: https://xquik.com/api/v1/x/users/{id}/followers
Auth: one of:
- API key in header x-api-key
- HTTP bearer
- none

Path parameters

idstring required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa or x.com/i/user/11348282. A number is a user ID. Writes look up a username's ID before sending. Anything else gets 400 invalid_user_id.

Query parameters

cursorstring

Cursor from the previous response. Existing unprefixed cursors keep legacy standard behavior. Pages can be empty before more rows. Follow next_cursor. Also read as next_cursor, next_token, pagination_token or continuation_token.

mode'standard' | 'coverage'

Omit mode for resumable maximum coverage. Standard keeps legacy pagination. Coverage returns diagnostics once and rejects cursors.

afterstring

Legacy cursor alias. Prefer cursor.

pageSizeinteger

Up to 300 user profiles in automatic mode, 200 in standard. Sources can return fewer. Follow next_cursor for more pages. Its aliases are limit, count, max_results, maxItems, max_items & per_page.

maxScaninteger

Most profiles 1 request reads, kept or dropped by the filters. The request then answers the profiles it kept, the count it dropped & the cursor to read on. Each request of a cursor may send its own value. Without it, a filtered read scans at most 100,000 profiles of the list across all its pages, & the page that reaches them ends the list with scanLimit. An unfiltered read has no scan limit. Automatic mode only.

minFollowersinteger

Whole number from 0.

Minimum follower count. Profiles the filter drops cost nothing.

maxFollowersinteger

Whole number from 0.

Maximum follower count. A profile without a count passes.

minFollowinginteger

Whole number from 0.

Profiles must follow at least this many accounts.

maxFollowinginteger

Whole number from 0.

Profiles may follow at most this many accounts.

minStatusesinteger

Whole number from 0.

Minimum post count. minPosts is also accepted.

maxStatusesinteger

Whole number from 0.

Maximum post count. maxPosts is also accepted.

minAccountAgeDaysinteger

Whole number from 0.

Minimum account age in whole days.

verifiedOnlyboolean

Only return verified profiles.

blueVerifiedOnlyboolean

Only return profiles X marks as blue verified. X marks many business & government accounts blue too. Use verifiedType for 1 badge type.

verifiedTypestring

Match the verification type exactly, ignoring case.

hasWebsiteboolean

Only return profiles with a website.

hasLocationboolean

Only return profiles with a location.

hasEmailboolean

Only return profiles that publish an email.

businessEmailOnlyboolean

Only return profiles that publish an email outside free webmail, such as Gmail.

emailDomainsstring

Only return profiles with an email at one of these domains. Separate domains with commas. Subdomains match.

bioContainsstring

Match any comma-separated or line-separated bio term, ignoring case.

locationContainsstring

Match a location substring, ignoring case.

usernameContainsstring

Match a username substring, ignoring case.

enrichProfilesboolean

Add each row's full profile, as GET /x/users/{id} returns it. Pages take several seconds longer.

limitinteger

Legacy page-size alias outside coverage mode. Coverage accepts 1-10000. Prefer pageSize.

fieldsstring

Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring

Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

List of user followers

Example response

{
  "users": [
    {
      "id": "34743251",
      "username": "SpaceX",
      "name": "SpaceX",
      "followers": 41936873,
      "following": 127,
      "verified": true,
      "isBlueVerified": true,
      "isVerified": true,
      "profilePicture": "https://pbs.twimg.com/profile_images/1697749409851985920/HbrI04tM_normal.jpg",
      "profilePictureOriginal": "https://pbs.twimg.com/profile_images/1697749409851985920/HbrI04tM.jpg",
      "coverPicture": "https://pbs.twimg.com/profile_banners/34743251/1681251194",
      "profileBannerUrl": "https://pbs.twimg.com/profile_banners/34743251/1681251194",
      "description": "SpaceX designs, manufactures and launches the world's most advanced rockets and spacecraft",
      "location": "Earth",
      "createdAt": "Thu Apr 23 21:53:30 +0000 2009",
      "statusesCount": 11834,
      "mediaCount": 4713,
      "protected": false,
      "url": "http://spacex.com",
      "contactInfo": {
        "links": [
          {
            "url": "http://spacex.com",
            "network": "website",
            "source": "url"
          }
        ]
      },
      "favouritesCount": 529,
      "possiblySensitive": false,
      "pinnedTweetIds": [
        "2104354931595423762"
      ],
      "verifiedType": "Business",
      "profile_bio": {
        "description": "SpaceX designs, manufactures and launches the world's most advanced rockets and spacecraft",
        "entities": {
          "description": {},
          "url": {
            "urls": [
              {
                "display_url": "spacex.com",
                "expanded_url": "http://spacex.com",
                "indices": [
                  0,
                  23
                ],
                "url": "https://t.co/VOJ6qEctND"
              }
            ]
          }
        }
      },
      "hasGraduatedAccess": true,
      "parodyCommentaryFanLabel": "None",
      "professional": {
        "category": [],
        "professional_type": "Business",
        "rest_id": "1681839322029502464"
      },
      "profileDescriptionLanguage": "en",
      "profileImageShape": "Square",
      "profileTranslatorType": "none",
      "superFollowEligible": false
    },
    {
      "id": "20536157",
      "username": "Google",
      "name": "Google",
      "followers": 31909314,
      "following": 298,
      "verified": true,
      "isBlueVerified": true,
      "isVerified": true,
      "profilePicture": "https://pbs.twimg.com/profile_images/2042749771337564160/AgOFPEL3_normal.jpg",
      "profilePictureOriginal": "https://pbs.twimg.com/profile_images/2042749771337564160/AgOFPEL3.jpg",
      "coverPicture": "https://pbs.twimg.com/profile_banners/20536157/1780004508",
      "profileBannerUrl": "https://pbs.twimg.com/profile_banners/20536157/1780004508",
      "description": "Here to help.",
      "location": "Mountain View, CA",
      "createdAt": "Tue Feb 10 19:14:39 +0000 2009",
      "statusesCount": 251787,
      "mediaCount": 38271,
      "protected": false,
      "url": "https://blog.google/newsletter-subscribe/",
      "contactInfo": {
        "links": [
          {
            "url": "https://blog.google/newsletter-subscribe/",
            "network": "website",
            "source": "url"
          }
        ]
      },
      "favouritesCount": 5327,
      "possiblySensitive": false,
      "pinnedTweetIds": [
        "2105388143902175529"
      ],
      "verifiedType": "Business",
      "profile_bio": {
        "description": "Here to help.",
        "entities": {
          "description": {},
          "url": {
            "urls": [
              {
                "display_url": "blog.google/newsletter-sub…",
                "expanded_url": "https://blog.google/newsletter-subscribe/",
                "indices": [
                  0,
                  23
                ],
                "url": "https://t.co/RS3iU87BGe"
              }
            ]
          }
        }
      },
      "hasGraduatedAccess": true,
      "parodyCommentaryFanLabel": "None",
      "professional": {
        "category": [
          {
            "icon_name": "IconBriefcaseStroke",
            "id": 713,
            "name": "Science & Technology"
          }
        ],
        "professional_type": "Business",
        "rest_id": "1504886752259059716"
      },
      "profileDescriptionLanguage": "en",
      "profileImageShape": "Square",
      "profileTranslatorType": "regular",
      "superFollowEligible": false
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

Changes

Oct 20, 202645942c75fdc2 Revision changes
- warning
  added the new topup_in_progress enum value to the ///// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status

Operation history