Documentation Python quickstart Blog Free tools Enterprise solutions hello@quanticdata.ioLog in
All collectors

Twitter (X) profile scraper API

Social & communities · v1.0.0 · x_profile

$0.001 / profile

$1.00 / 1K · pay per delivered profile

A Twitter profile scraper API for X: send handles or profile URLs and get one row per account with the exact follower, following, post and like counts, the bio, location and website, the join date and the verification type. No X API key and no login, billed per profile delivered.

$0.001 per delivered profile · $2 free every month · Failed runs never billed

What it does

What a Twitter profile scraper returns

A profile is what you check before you read a single tweet: how big the account is, how old, who verified it and where it points. Give the collector a list of handles and each comes back as one row, with the counts as plain numbers, the website behind its t.co short link and the creation date in ISO 8601, ready to store next to yesterday’s row and compare.

On 13 November 2026 NASA’s public record read 92,248,190 followers and 74,538 posts, for an account created on 19 December 2007, with verified_type set to Government: the grey mark X gives to government accounts. Business accounts carry the gold one and everyone else gets null, so a list of brands, agencies and creators splits by how X itself labels them.

Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

InputTypeRequiredWhat it does
usernamesstring[]yesX handles, with or without @, or profile URLs, one per line, up to 50.
countrystringnoTwo-letter country code (ISO 3166-1) the request is made from. Leave it out for the default.
max_resultsintegernoHow many profiles to deliver at most (1–50). You pay only for delivered profiles.

Outputs — 20 fields, one row per profile

What one profile looks like

Every delivered profile carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

FieldTypeWhat it holds
rankinteger1-based delivery order.
usernamestringProfile handle.
user_idstring · nullableX's numeric id of the account.
namestring · nullableDisplay name.
descriptionstring · nullableProfile bio.
locationstring · nullableLocation as the profile states it.
websitestring · nullableWebsite on the profile, with the short link expanded.
followersinteger · nullableExact follower count.
followinginteger · nullableAccounts followed.
postsinteger · nullablePosts published.
likesinteger · nullablePosts the account liked.
mediainteger · nullablePhotos and videos posted.
listedinteger · nullableLists the account is on.
created_atstring · nullableAccount creation time (ISO 8601).
verifiedbooleanVerified badge on the profile.
verified_typestring · nullableBusiness or Government for the gold and grey marks; null otherwise.
protectedbooleanTrue when the account's posts are protected.
profile_imagestring · nullableProfile picture URL (400 px).
bannerstring · nullableBanner image URL.
urlstringProfile URL.

Integration

One POST, typed rows

Base URL https://api.quanticdata.io/v1, Bearer auth, the same key as every other Data API. Endpoint: POST /v1/scraper/collectors/x_profile/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/x_profile/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["NASA","@SpaceX"],"max_results":2}'

Example response

POST /v1/scraper/collectors/x_profile/run
$ curl $QD/x_profile/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"usernames": ["NASA", "@SpaceX"], "max_results": 2}'
{ "status": "done", "count": 2,
  "results": [
    {
      "username": "…",
      "followers": "…",
      "posts": "…",
      "created_at": "…" } ],
  "cost": 0.002 }
# 2 profiles × $0.001 · nothing delivered, nothing charged

Try it

X profiles, running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

Get my free API key
Twitter (X) profile scraper API: from usernames, QuanticData reads the X profile and returns one row per profile with username, followers and created_at, at $0.001 per delivered profile.
You send X handles; each comes back as one row with username, followers and created_at — 20 fields on every row — and you are billed $0.001 for each profile actually delivered, nothing for a run that delivers none.
$0.001 / profile2,000 profiles on the free $2 every month
Semantic inputusernames, country, max_results — no URL lists
Up to 50profiles per run, pagination handled for you
20 fieldsone row per profile

Pricing

Twitter (X) Profile Scraper pricing

$0.001 per delivered profile. A run that delivers nothing costs nothing, and the $2 monthly allowance covers about 2,000 profiles before you spend anything.

$0.001per delivered profile$1.00 per 1,000 delivered profiles
2,000 profileson the free allowance$2 every month, no card
Zero rowszero chargea run that delivers nothing is free
−30%on volume tiersthe catalog returns your key's price

Same wallet, same key and same $2 monthly allowance as every other Data API. Prices are launch pricing read live from the billing config — GET /v1/scraper/collectors returns the price your key actually pays.

What people build with the Twitter profile scraper

Three shapes of work this endpoint was designed around.

Creator and influencer vetting

Followers, posts, join date and verification type for a shortlist of creators, read the day you contact them, so a campaign brief starts from numbers instead of screenshots.

Audience tracking over time

Run the same handles every day and keep the rows: follower growth, posting rate, bio and website changes for your brand and the ones you compete with, next to their latest posts from the Twitter scraper API.

Enriching a list of accounts

Handles from a CRM, a conference list or a search become rows with location, website and exact counts, ready to filter before anyone writes a message.

Twitter (X) Profile Scraper versus rolling your own

The differences that actually cost time when you build this in-house.

DIY scraperThis collector
AccessA developer account, or the cookies of an account you riskOne API key, no X account involved
Counts“12K” labels to parseExact followers, following, posts and likes
WebsiteA t.co short linkExpanded to the real address
VerificationA badge colour to read off an imageverified and verified_type as fields
Join dateA “Joined December 2007” linecreated_at in ISO 8601
BillingCalls, whatever they returnOnly delivered profiles
Twitter (X) profile scraper API: the POST to the x_profile collector, 2 profiles delivered and the bill, 2 × $0.001 = $0.002 in usage.cost_usd; zero profiles would cost $0.
The same call you would paste into a terminal: a Bearer key, the handles in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many profiles arrived and usage.cost_usd is $0.002, which is 2 × $0.001. A run that delivers nothing costs nothing.

Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

FAQ

Questions we get about the Twitter profile scraper.

Something else? Ask us

Can I get a Twitter follower count without the X API?

Yes. Send the handle and the row carries followers as an exact number, with following, posts, likes and listed next to it. You need a QuanticData key, not an X developer account.

How many profiles can I send in one run?

Up to 50 handles or profile URLs, with or without the @. Each delivered profile costs $0.001, and a handle that returns nothing is not billed.

Can I scrape a profile’s tweets as well?

Yes, with a second collector: the Twitter scraper API returns each profile’s latest public tweets with exact counts. Same key, same wallet, billed per tweet.

Is scraping Twitter profiles legal?

The collector reads only what X shows publicly to a visitor who is not signed in. How you may use the data depends on X’s Terms of Service and on the law where you work, so check both for your use case.

Is there a free Twitter profile scraper?

Every account gets $2 of credit every month with no card, which is about 2,000 delivered profiles on this endpoint at $0.001 each. It renews monthly, and a run that delivers nothing is never billed.

How much does one run cost?

Multiply the rows you actually receive by $0.001. A run capped at 50 profiles — the maximum for this collector — costs $0.05 if every row comes back, and less when the listing has fewer. Volume tiers take up to 30% off, and GET /v1/scraper/collectors returns the price your key actually pays.

Run the Twitter profile scraper now

$2 of free credit every month, no card. Your key returns its own prices from GET /v1/scraper/collectors.

Get my free API key
Illustration: three coloured zones of the page that is read (X profile) turn into clean JSON with the fields username, followers and created_at; 20 fields on every row.