Social & content · REST API · MCP server

X (Twitter) Scraper API

Get any public post on X (Twitter) from its ID: the text, who posted it, when, and its likes and replies, as clean JSON. No X account, no API approval.

10 credits per call
Failed calls are free
Updated 9 Oct 2026

Start free, 100 credits Docs

x.tweet.syndication completed

textstringjust setting up my twttr

authorstringjack

author_namestringjack

createdstring2006-03-21T20:50:14.000Z

likesinteger308,818

repliesinteger18,073

langstringen

urlstringhttps://x.com/jack/status/20

is_quotebooleanfalse

is_replybooleanfalse

is_retweetbooleanfalse

idstring20

Every field and the JSON Try it live, free

Endpoints

X (Twitter) API endpoints

What each one takes and what it returns. Open one for a real response, every input and every field.

X (Twitter) Tweet API

Get one public post from its numeric ID: text, author handle and name, post time, language, likes and replies, and whether it is a reply, quote or repost.

Sendtweet_id Returnstextauthorauthor_namecreatedlikesreplies

10 credits

Use cases

What teams build with X (Twitter) data

Check posts cited in reports
Confirm what a public post says, who posted it and when, straight from the post's ID.
Tweet
Add engagement to your data
Turn a list of post IDs into rows with text, author, time, likes and replies.
Tweet

Know before you build

How X (Twitter) data behaves

Public posts onlyPosts from protected accounts, and deleted posts, are not available. A post that cannot be read publicly answers not found.
Likes and replies as X shows themCounts are X's own numbers at the moment of the call.
Text firstThe response carries the post's text and details. Images and videos attached to a post are not part of it yet.
Replies, quotes and reposts markedEach post says whether it is a reply, a quote or a repost, so you can tell them from original posts.

REST API · MCP server

Call it from your code, or ask your agent

One request shape for every X (Twitter) endpoint: the endpoint ID and its input. No SDK needed.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "x.tweet.syndication",  "input": {    "tweet_id": "20"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "x.tweet.syndication",  "input": {    "tweet_id": "20"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "x.tweet.syndication",  "input": {    "tweet_id": "20"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

Response

{  "text": "just setting up my twttr",  "likes": 308818,  "author": "jack",  "author_name": "jack",  "created": "2006-03-21T20:50:14.000Z",  "id": "20",  "is_quote": false,  "is_reply": false,  "is_retweet": false,  "lang": "en",  "replies": 18073,  "url": "https://x.com/jack/status/20"}

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

Use Upscrape to get the X post with ID 20. Who posted it, when, what does it say, and how many likes and replies does it have?

The agent finds the endpoint, shows you the price, and runs it with your credits.

Social & content

Questions

X (Twitter) Scraper API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.

Book a call [email protected]

Is there an official X API for this?

X's own API needs a developer account, and reading posts is part of its paid plans. Upscrape reads public posts without one: send a post ID, get its text, author, time, likes and replies.

Can I search X or read a whole timeline?

Not yet. This endpoint gets one public post from its ID; to work through many posts, send each ID in its own call.

Do I need an X account?

No. Nothing runs on your account, and you share no password or cookie.

Where do I find a post's ID?

It is the number at the end of the post's link. In x.com/jack/status/20 the ID is 20.

What data can I get from X (Twitter)?

Tweet. Each is its own endpoint with a published input schema, and the response is JSON.

How much does the X (Twitter) API cost?

Every X (Twitter) endpoint costs 10 credits per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.

Can an AI agent use the X (Twitter) API?

Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the X (Twitter) endpoint, checks its price and runs it with the same credits as the REST API.

Is it legal to scrape X (Twitter)?

Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.

Get started

Your first X (Twitter) call is free.

Up to 100 free credits to start, no card needed.

Start building for free Book a call