Threads API · Endpoint
Threads Post API
Get one post from its link, or its handle and ID: text, likes, replies, reposts, quotes and post time.
- 1 credit per call
- Failed calls are free
- Updated
- threads.post
Response
completed
{ "title": "Instagram (@instagram) on Threads", "handle": "instagram", "canonical_url": "https://www.threads.com/@instagram/post/DeRpgdFlhJa", "description": "there are morning people and then there are people who are correct", "post_id": "DeRpgdFlhJa", "content": { "caption": "there are morning people and then there are people who are correct", "like_count": 386, "media_type": 19, "quote_count": 4, "reply_count": 55, "repost_count": 20, "taken_at_unix": 1791553578 }}
content.captionstringthere are morning people and then there are people who are corr…
handlestringinstagram
content.like_countinteger386
content.reply_countinteger55
content.repost_countinteger20
content.quote_countinteger4
content.taken_at_unixinteger1,791,553,578
titlestringInstagram (@instagram) on Threads
content.media_typeinteger19
descriptionstringthere are morning people and then there are people who are corr…
canonical_urlstringhttps://www.threads.com/@instagram/post/DeRpgdFlhJa
post_idstringDeRpgdFlhJa
Input
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| handle | string | one of | The author's handle, as an alternative to the link. Send it with post_id. | |
| post_id | string | one of | The post's short ID from its link, sent with handle. | |
| post_url | string | one of | The post's www.threads.com link. Send it alone. | https://www.threads.com/@instagram/post/DeRpgdF… |
Response
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| content | object | The post. | 7 fields |
| content.caption | string | The post's text. | there are morning people and then there are people who are corr… |
| content.like_count | integer | Likes, as Threads shows them. | 386 |
| content.reply_count | integer | Replies, as Threads shows them. | 55 |
| content.repost_count | integer | Reposts, as Threads shows them. | 20 |
| content.quote_count | integer | Quotes, as Threads shows them. | 4 |
| content.taken_at_unix | integer | When it was posted, as a Unix time in seconds. | 1,791,553,578 |
| content.media_type | integer | Threads' media type code for the post. | 19 |
| handle | string | The posting account's handle. | |
| title | string | The page title Threads shows. | Instagram (@instagram) on Threads |
| canonical_url | string | The page's address on Threads. | https://www.threads.com/@instagram/post/DeRpgdFlhJa |
| description | string | The post's text, as the page shows it. | there are morning people and then there are people who are corr… |
| post_id | string | Threads' ID for the post. | DeRpgdFlhJa |
REST API · MCP server
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
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": "threads.post", "input": { "post_url": "https://www.threads.com/@instagram/post/DeRpgdFlhJa" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "threads.post", "input": { "post_url": "https://www.threads.com/@instagram/post/DeRpgdFlhJa" }}''')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": "threads.post", "input": { "post_url": "https://www.threads.com/@instagram/post/DeRpgdFlhJa" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
With Upscrape, open threads.com/@instagram/post/DeRpgdFlhJa and tell me its likes, replies, reposts and quotes.
Threads
More from the Threads API
Same data, other platforms
The same data from other platforms
FacebookPost
InstagramPost
LinkedInPost
RedditPost
TikTokVideo detail
TumblrPost
Questions
Threads Post API FAQ
The short answers. The docs have the long ones.
Still have a question?
Talk to the people who build the endpoints.
How much does the Threads Post API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Every input is optional; the input fields below list what each one does.
Do I need a Threads login?
No. It reads public Threads data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds threads.post, checks its price and runs it with the same credits as the REST API.
Get started
Your first Threads call is free.
Up to 100 free credits to start, no card needed.