Twitter / X profile API: follower count and account data as JSON

Send a Twitter / X handle and get the public profile back as JSON, including name, screen_name, description, followers count and account statistics. It is one REST call with one API key, so you can check follower counts in bulk without an X developer plan. The response is plain JSON, so you can write it straight into a spreadsheet, a database or a CRM field, and each successful call is billed on its own.

Buy credits

Use cases

Endpoints and cost

EndpointWhat it returnsCredits/callUSD/call (Freelance plan)
/v1/twitter/userProfile1$0.0017

Endpoint details

/v1/twitter/user

Profile 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.

ParameterTypeRequiredDescription
handlestringyesTwitter handle
cache_max_agestringnoIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp).

Sample response (trimmed):

{
 "typename": "User",
 "id": "VXNlcjoyMjE4MzgzNDk=",
 "rest_id": "221838349",
 "affiliates_highlighted_label": {
  "label": {
   "url": {
    "url": "https://twitter.com/bloomtech",
    "url_type": "DeepLink"
   },
   "badge": {
    "url": "https://pbs.twimg.com/profile_images/1542996246477938688/PR4UFtE6_bigger.jpg"
   },
   "description": "Bloom Institute of Technology",
   "user_label_type": "BusinessLabel",
   "user_label_display_type": "Badge"
  }
 },
 "is_blue_verified": true,
 "profile_image_shape": "Circle",
 "legacy": {
  "created_at": "Wed Dec 01 19:13:23 +0000 2010",
  "default_profile": false,
  "default_profile_image": false,
  "description": "CEO https://t.co/m6TigM5azr & https://t.co/NuPTghEZ1I (part of @bloomtech). We help teams maximize productivity using AI. Will tweet as I wish and suffer the...",
  "entities": {
   "description": {
    "urls": [
     {
      "display_url": "GauntletAI.com",
      "expanded_url": "http://GauntletAI.com",
      "url": "https://t.co/m6TigM5azr",
      "indices": [
       4
      ]
     }
    ]
   },
   "url": {
    "urls": [
     {
      "display_url": "gauntletai.com",
      "expanded_url": "http://gauntletai.com",
      "url": "https://t.co/nCe0AdT8D4",
      "indices": [
       0
      ]
     }
    ]
   }
  },
  "fast_followers_count": 0,
  "favourites_count": 80812,
  "followers_count": 377608,
  "friends_count": 1051,
  "

Example: curl

curl -H "X-Scapi-Key: $SCAPI_KEY" "https://api.scrapall.bipsport.com/scapi/v1/twitter/user"

Example: Python

import os, requests
r = requests.get("https://api.scrapall.bipsport.com/scapi/v1/twitter/user",
    headers={"X-Scapi-Key": os.environ["SCAPI_KEY"]})
print(r.json())

FAQ

How do I get the follower count of an X account?

Call the profile endpoint with the handle. The JSON response includes followers count together with other account metadata and statistics, so one call gives you both the number and the context around it.

Do I need an X developer account?

No. You only send the handle and your API key header. There is no X developer app or OAuth token involved, and no monthly developer plan to buy before your first request.

What is cache_max_age?

An optional parameter that controls how old a cached profile result may be. Leave it out for the default behaviour, or set it when you need fresher data, for example in a daily tracking job.

Does it return the full follower list?

No. This endpoint returns the profile and its statistics, such as followers count, not the list of follower accounts.

Can I look up many handles?

Yes. Call the endpoint once per handle. Each successful call is billed separately, so the cost grows with the number of handles you check.

How do I pay and get my API key?

Open the Buy page, pick the Freelance plan and pay in USDT on TRC20 or ERC20. The key is shown once, right after the payment is confirmed on-chain.

How many credits does one call use?

The cost table on this page lists credits per call for each endpoint. The Freelance plan is $45 for 27,000 credits per 30 days.

Get an API key and credits

Full reference: all twitter endpoints.