New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →

X (Twitter) Scraper API: 19 endpoints, structured JSON

Profile posts, single posts, followers and following, Communities and video transcripts: every X (Twitter) endpoint Scrapier ships, each returning typed JSON in the same response envelope. Public data only.

Copy for your AI agent
19X (Twitter) endpoints
1–2credits per successful call
0credits for a failed call
3need no X (Twitter) login
Quick answerScrapier returns typed JSON from 19 X (Twitter) endpoints: profile posts, single posts, followers and following, Communities and video transcripts. Public data only and no proxies; 3 endpoints need no X (Twitter) login and 3 take your own session cookie. 1 or 2 credits per successful call; failed calls are free. Last verified 9 Nov 2026
Endpoints

What data can I extract with X (Twitter) Scraper?

Pick the data you need. Each endpoint takes a username, a post link or a Community ID and gives you clean JSON back, for 1 or 2 credits per successful call.

Profile postsStart here

GET/api/v2/twitter-tweets/

An account's posts, a page at a time, with text, like, reply, repost, quote, bookmark and view counts.

1 credit per callView →Page soon

Posts

GET/api/v2/twitter-post/

Posts by username or status URL, with engagement counts and the author's follower and post counts.

1 credit per callView →Page soon

Video transcript

GET/api/v2/twitter-transcript/

Speech-to-text transcript of a video post, with language and duration.

2 credits per callView →Page soon

User networkSession cookie

GET/api/v2/twitter-user-scraper/

Accounts around a user: followers, following and retweeters, with follower counts. Takes your own X cookies.

2 credits per callView →Page soon

Community infoSession cookie

GET/api/v2/twitter-community-info/

A Community's name, member count, join policy, creator and admin. Takes your own X auth_token.

2 credits per callView →Page soon

Community postsSession cookie

GET/api/v2/twitter-community-tweets/

Posts in a Community with text, likes, reposts, replies and author. Takes your own X auth_token.

2 credits per callView →Page soon

Followers

INprofileUrl

Accounts that follow a profile: name, handle, bio, verified type, follower, following and post counts. Takes your own X cookies.

Same API key and JSON envelope

Following

INusernames

Accounts a profile follows: name, handle, bio, verified type, follower and post counts, join date. Takes your own X cookies.

Same API key and JSON envelope

Followers and following

INuser_names

Both lists for an account in one run: name, handle, location, bio and follower count of each. Takes your own X cookies.

Same API key and JSON envelope

Replies and retweets

INurls

Replies to a post, or the accounts that retweeted it, chosen by category. Takes your own X cookies.

Same API key and JSON envelope

Post search

INsearchQueries

Posts matching a search query, with text, likes, replies, retweets, quotes, media and author details. Takes your own X cookies.

Same API key and JSON envelope

Account post search

INstartUrls

Top or latest posts for a handle or term, over an optional time window.

Same API key and JSON envelope

Trends

INlive

Trending topics by position, with post volume and link, live or over the last hour to three days.

Same API key and JSON envelope

Email finder

INkeywords

Public emails found on X pages for a keyword, with the page title, description and URL of each match.

Same API key and JSON envelope

X emails by keyword

INkeywords

Public emails on X profiles and posts that match a keyword, filtered by email domain, with the source URL.

Same API key and JSON envelope

Profile emails

INkeywords

Public emails on X profile pages for a keyword and location, with the page title and URL.

Same API key and JSON envelope

Phone number finder

INkeywords

Public phone numbers on X pages for a keyword and country, with the dial code, page title and URL.

Same API key and JSON envelope

X phones by keyword

INkeywords

Public phone numbers on X profiles and posts that match a keyword, with country, dial code and source URL.

Same API key and JSON envelope

Profile phone numbers

INkeywords

Public phone numbers on X profile pages for a keyword and country, with the dial code and URL.

Same API key and JSON envelope
Playground

Try X (Twitter) Scraper Live

Pick an endpoint, fill in the input and press Run. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

X (Twitter)Profile postsLive

Parameters
+ Run live with your API key
Response
Sample dataCatalog sample, run to see live data
Pricing

How much will scraping X (Twitter) cost?

Every successful call costs 1 or 2 credits, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 2 credits cost $3.16. Scale brings that to $2.39, so 125,000 X (Twitter) calls a month is $299.

See all plans →
PlanPrice / moCredits / moPer 1,000 calls
Free$0Free tier—
Hobby$2915,000$3.87
Pro$7950,000$3.16
Scale$299250,000$2.39
How to

How do I use X (Twitter) Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get X (Twitter) data in a few minutes:

  1. Create a free Scrapier accountSign up with your email and copy your API key.
  2. Pick the endpoint for your dataProfile posts, single posts, video transcripts, followers and following, or Communities.
  3. Add your inputOne username, post URL or Community ID per call.
  4. Page through the resultsList endpoints return next_cursor; pass it back as cursor for the next page.
  5. Add your X cookies where neededtwitter-user-scraper takes your own auth_token and ct0 cookies; the Community endpoints take auth_token.
  6. Run the requestOne GET with your key in the X-API-Key header, or ask your AI agent over MCP.
  7. Save the resultsJSON from the API: store it as is, or flatten it to CSV in a few lines.
Input

Input

Two ways in. Use whichever matches what you already have.

1

By username or handle

You already know which accounts you want.

Profile postselonmusk
Best fortracking known accounts · one value per call, up to 3 calls in parallel
2

By URL

You already have the links to the pages you want.

Video transcriptx.com/MrBeast/status/2096285173788840001
Best forknown pages · paste the link as it is
Example requests
// GET /api/v2/twitter-tweets/
{
  "usernames": "elonmusk",
  "with_replies": "true",
  "include_user_info": "true"
}
// or
// GET /api/v2/twitter-post/
{
  "usernames": "elonmusk"
}
Send thisParameterAnd you can get
UsernameusernamesThe account's posts, with replies and user info on request
Username or post URLusernamesPosts with engagement counts and author stats
Username + X cookiesusernames · auth_token · ct0Followers, following and retweeters
Community ID + X cookiecommunities · auth_tokenCommunity details, and its posts with community_ids
Video post URLurlsThe video's transcript, language and duration

Optional on list endpoints: cursor (pass back next_cursor for the next page). Auth is one header: X-API-Key. Send parameters in the query string (GET) or as a JSON body (POST).

Output

Output

The one thing to know: each data type has its own shape. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/twitter-tweets/?usernames=elonmusk
// one item of data.tweets · catalog sample
{
  "id": "1948167071684231344",
  "tweet_id": "1948167071684231344",
  "url": "https://x.com/BillGates/status/1948167071684231344",
  "verified": true,
  "username": "@BillGates",
  "fullname": "Bill Gates",
  "timestamp": "Wed Jul 23 23:43:19 +0000 2025",
  "text": "Learning how many kids were dying from diarrhea back in 1997 ... https://t.co/NYitqiRY38",
  "links": [
    "https://gatesnot.es/46lTfBz"
  ],
  "isPinned": false,
  "isQuote": false,
  "isRetweet": false,
  "isReply": false,
  "likes": 5219,
  "replies": 0,
  "retweets": 1816,
  "quotes": 598,
  "bookmarks": 334,
  "views": 2828080,
  "lang": "en",
  "user": {
    "avatar": "https://pbs.twimg.com/profile_images/1879013694367252480/Gxa-Pspq_normal.jpg",
    "username": "BillGates",
    "userFullName": "Bill Gates",
    "description": "Sharing things I'm learning through my foundation work and other interests.",
    "location": "Seattle, WA",
    "website": "https://gatesnot.es/tgn",
    "joinDate": "Wed Jun 24 18:44:10 +0000 2009",
    "verified": true,
    "totalLikes": 542,
    "totalTweets": 4521,
    "totalFollowing": 571,
    "totalFollowers": 65231300,
    "url": "https://t.co/TiXXwOGE95",
    "userId": "50393960",
    "totalMediaCount": 1530
  },
  "media": [],
  "tweetUserId": "50393960",
  "input_username": "BillGates",
  "scraped_at": "2026-10-03T03:35:53.722Z"
}

Every response is {"success": true, "data": {…}}: your input echoed back, the result under its own key (profile, posts, comments…) and next_cursor for the next page.

Use cases

What can you do with X (Twitter) data?

Public X (Twitter) data powers social listening, influencer research, competitor tracking, community research and video analysis. Here are five common jobs, and the X scraper endpoints each one chains together.

01

Competitor and brand tracking

Pull the latest posts from competitor and brand accounts on a schedule, with likes, replies, reposts and views. See which posts land and how often each account posts.

  1. 1tweets
  2. 2post
  3. Benchmark
DailyDashboard
02

Influencer research

Start from a known creator's posts, then map the accounts around them: followers, following and retweeters, each with a follower count. The user network endpoint takes your own X cookies.

  1. 1tweets
  2. 2user-scraper
  3. Shortlist
WeeklyCreator CRM, Sheets
03

Community research

Read what members of an X Community talk about: its size and join policy, then its latest posts with engagement. Both endpoints take your own X auth_token.

  1. 1community-info
  2. 2community-tweets
  3. Topic feed
DailyNotebook, LLM
04

Video content analysis

Transcribe video posts from news, sports or creator accounts and run the text through search or an LLM, so video is as searchable as text posts.

  1. 1tweets
  2. 2transcript
  3. Transcript set
DailyDatabase, LLM
05

Executive and newsroom monitoring

Follow posts from executives, officials and journalists, and keep a timestamped archive of every post with its counts at the time of the call.

  1. 1tweets
  2. Post archive
HourlyDatabase, alerts
Features

Features

X (Twitter) Scraper fetches clean, structured X data at low cost: built for social listening, influencer research, competitor tracking and AI agents.

Live data, every call

Each request reads X at call time, and most responses say when in scraped_at.

Typed, consistent JSON

Same field names on every call, counts as numbers, ready for code, sheets or an LLM.

Lists, page by page

List endpoints return next_cursor; run up to 3 requests in parallel per key.

19 endpoints, one shape

Posts, users, Communities and transcripts share the same envelope and auth.

MCP-ready for AI agents

The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

No developer account

Public data only. 3 of the 6 live endpoints need no X login; users and Communities take your own X cookies.

Maintained for you

When X changes its pages, Scrapier updates the scraper; your field names stay the same.

Pay per successful call

1 or 2 credits per call, however many posts the page holds. Failed calls are never billed.

Why Scrapier

Why choose this X (Twitter) Scraper?

The official X API reads public posts, but it needs a developer account and an app, and read volume beyond the smallest tier is paid. Scrapier reads public X posts and video transcripts with one API key, at a price you know before the call runs; user lists and Communities take your own X cookies.

0Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

$2.39Per 1,000 calls on Scale

At 2 credits a call; profile posts and single posts cost 1 credit. No compute units to estimate.

0Developer apps needed

Profile posts, single posts and transcripts need no X developer account, app or bearer token.

1 keyFor 35 platforms

The same key and JSON envelope cover Threads, Bluesky, Reddit, LinkedIn and more.

FeatureScrapier X (Twitter) ScraperX APIDIY scraper
Whose dataAny public account or postAny public account or postAny public account
SetupOne API keyDeveloper account, app, tokensProxies, accounts, parsers
MaintenanceHandled by ScrapierVersion and policy changesBreaks on layout changes
CostFrom $2.39 per 1,000 callsPaid plans for most read volumeServers, proxies and engineering time
AI agentsMCP server includedNot includedBuild your own
FAQ

Frequently asked questions

Can I scrape several data types in one call?

No. Each endpoint returns one data type. To get an account's posts and the transcript of a video post, call twitter-tweets then twitter-transcript with the post URL, or let an AI agent chain the calls over MCP.

Which X endpoints need my own cookies?

Three of the six live endpoints. twitter-user-scraper takes your auth_token and ct0 cookies; twitter-community-info and twitter-community-tweets take auth_token. Profile posts, single posts and video transcripts need no X login.

Can I scrape protected X accounts?

No. Scrapier reads public data only. A protected account's posts are visible only to its approved followers, so they are not returned by any endpoint.

How many posts can I get?

As many as X shows publicly. List endpoints return a page at a time with next_cursor; pass it back as cursor for the next page. Each page of profile posts is one call at 1 credit.

Can I get a transcript of an X video?

Yes. twitter-transcript takes a post URL with a video and returns the transcript, the detected language and the duration. Set translate_to_english to get English text, and max_duration_seconds to skip long videos.

Why don't some counts match what I see on X?

Counts are a snapshot from the moment of the call, so likes, reposts and views keep changing after it. Some fields, such as views on older posts, can be null when X doesn't show them.

Is it legal to scrape X (Twitter)?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Some of it can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use.

Can I connect X data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON response.

Can I get X data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right X endpoint with search_endpoints and calls it with run_scrape, in Claude Code, Cursor or Windsurf.

X (Twitter) Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

How much does the X (Twitter) scraper cost?

Profile posts and single posts cost 1 credit per successful call; users, Communities and transcripts cost 2. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

What are the X (Twitter) scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.

How do I scrape X (Twitter) with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/twitter-tweets/", headers={"X-API-Key": key}, params={"usernames": "BillGates"}, timeout=210). The response is JSON, so read r.json()["data"]["tweets"] directly; there is no HTML to parse. Loop over your list for more accounts.

Get started

Start pulling X (Twitter) data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.