Scraperize
Sign in
Twitter / X

Twitter / X Profile API

To get a user profile from Twitter / X, call GET /v1/twitter/profile?handle=… with your API key. You get clean JSON back.

GET/v1/twitter/profile
curl "https://api.scraperize.com/v1/twitter/profile?handle=thedankoe" \
  -H "x-api-key: YOUR_API_KEY"
Cost
1 credit / call
Only successful calls are charged. Errors are free.
Pagination
Single response
Everything comes back in one call.
Caching
0 credits
Set cache_max_age to reuse a recent result for free.
Rate limit
Per team / minute
Over the limit: 429 with a Retry-After header.

Parameters

handleRequired
User handle WITHOUT the @ symbol, e.g. thedankoe.
cache_max_ageOptional
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.One of 5 values.

Send your key in the x-api-key header. Full API reference

Example response

200 OK · application/json
{
  "data": {
    "profile": {
      "id": "256523056",
      "name": "DAN KOE",
      "screenName": "thedankoe",
      "url": "https://x.com/thedankoe",
      "bio": "a better place to build a creator business: @edendotso",
      "location": "the goods:",
      "website": {
        "url": "https://t.co/t9rHIYvRYk",
        "displayUrl": "thedankoe.eden.so",
        "expandedUrl": "https://thedankoe.eden.so"
      },
      "avatarUrl": "https://pbs.twimg.com/profile_images/1845856303174037504/Q7ZZqVFa_normal.jpg",
      "avatarUrlHd": "https://pbs.twimg.com/profile_images/1845856303174037504/Q7ZZqVFa_400x400.jpg",
      "bannerUrl": "https://pbs.twimg.com/profile_banners/256523056/1711767394",
      "stats": {
        "followers": 1034743,
        "following": 959,
        "tweets": 30350
      },
      "verified": true,
      "verifiedType": null,
      "protected": false,
      "professional": false,
      "professionalCategory": null,
      "profileImageShape": "Circle",
      "joined": "February 2011"
    },
    "fetchedAt": "2026-10-05T14:42:30.937Z"
  },
  "meta": {
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
    "creditsCharged": 1,
    "creditsRemaining": 4999,
    "cached": false
  }
}

A real response, shortened to one item per list.

More Twitter / X endpoints

User tweetsTweetCommunityCommunity tweets
FAQ

Twitter / X Profile API questions

How much does the Twitter / X Profile API cost?

1 credit per successful call. Errors and cached results are free, and new accounts start with 100 free credits, no card required. See pricing.

Do I need a Twitter / X account or API key?

No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Twitter / X login or developer app is needed.

How fresh is the data?

Each call fetches the data live. To trade freshness for cost, pass cache_max_age (e.g. 1h, 1d) to get a recent cached result instantly for 0 credits.

Where are the full parameters and response fields?

In the API reference, with every parameter, field and error.

Try the Twitter / X Profile API

Grab your key and 100 free credits, no card required, and run this call in minutes.