# X (Twitter) Scraper API: 19 Endpoints, Typed JSON | Scrapier (https://scrapier.io/scrapers/x-twitter/)

> X (Twitter) scraper API with 19 endpoints: posts, followers, Communities and video transcripts as typed JSON. 1 or 2 credits per call. Get a free API key.

Last updated: 2026-11-11

## 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.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**19**X (Twitter) endpoints

**1–2**credits per successful call

**0**credits for a failed call

**3**need 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 call_View →Page soon_](https://scrapier.io/scrapers/x-twitter/profile-tweets/)[### 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 call_View →Page soon_](https://scrapier.io/scrapers/x-twitter/posts/)[### Video transcript

`**GET**/api/v2/twitter-transcript/`

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

2 credits per call_View →Page soon_](https://scrapier.io/scrapers/x-twitter/transcript/)

### 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 call_View →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 call_View →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 call_View →Page soon_

### Followers

`**IN**profileUrl`

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

`**IN**usernames`

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

`**IN**user_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

`**IN**urls`

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

`**IN**searchQueries`

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

`**IN**startUrls`

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

Same API key and JSON envelope

### Trends

`**IN**live`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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

`**IN**keywords`

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 posts**Live

Platform

Endpoint

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 →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $3.87 |
| Pro | $79 | 50,000 | $3.16 |
| Scale | $299 | 250,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:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**Profile posts, single posts, video transcripts, followers and following, or Communities.
3. **Add your input**One username, post URL or Community ID per call.
4. **Page through the results**List endpoints return `next_cursor`; pass it back as `cursor` for the next page.
5. **Add your X cookies where needed**`twitter-user-scraper` takes your own `auth_token` and `ct0` cookies; the Community endpoints take `auth_token`.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON 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 posts`elonmusk`

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 transcript`x.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 this | Parameter | And you can get |
| --- | --- | --- |
| Username | `usernames` | The account's posts, with replies and user info on request |
| Username or post URL | `usernames` | Posts with engagement counts and author stats |
| Username + X cookies | `usernames` · `auth_token` · `ct0` | Followers, following and retweeters |
| Community ID + X cookie | `communities` · `auth_token` | Community details, and its posts with community\_ids |
| Video post URL | `urls` | The 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. _1_tweets
2. _2_post
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. _1_tweets
2. _2_user-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. _1_community-info
2. _2_community-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. _1_tweets
2. _2_transcript
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. _1_tweets
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.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

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

**$2.39**Per 1,000 calls on Scale

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

**0**Developer apps needed

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

**1 key**For 35 platforms

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

| Feature | Scrapier X (Twitter) Scraper | X API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Any public account or post | Any public account or post | Any public account |
| Setup | One API key | Developer account, app, tokens | Proxies, accounts, parsers |
| Maintenance | Handled by Scrapier | Version and policy changes | Breaks on layout changes |
| Cost | From $2.39 per 1,000 calls | Paid plans for most read volume | Servers, proxies and engineering time |
| AI agents | MCP server included | Not included | Build 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.

Other platforms

## You might also like

[### Threads

6 endpoints](https://scrapier.io/scrapers/threads/)[### Bluesky

3 endpoints](https://scrapier.io/scrapers/bluesky/)[### Truth Social

4 endpoints](https://scrapier.io/scrapers/truth-social/)[### Reddit

9 endpoints](https://scrapier.io/scrapers/reddit/)[### Instagram

20 endpoints](https://scrapier.io/scrapers/instagram/)[### LinkedIn

8 endpoints](https://scrapier.io/scrapers/linkedin/)

Get started

## Start pulling X (Twitter) data in 60 seconds

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

[Get your API key →](https://app.scrapier.io/sign-up)[See the Profile posts endpoint](https://scrapier.io/scrapers/x-twitter/profile-tweets/)

---
Canonical page: https://scrapier.io/scrapers/x-twitter/
Site index for AI agents: https://scrapier.io/llms.txt
