Threads Post API
Scrape Threads Post data with one API call. Returns detailed information about a specific Threads post including the text content, like count, reply count, repost count, media attachments, author info, and creation timestamp. Carousel posts return every slide as an array in `content.media_urls`; video posts return a playable video URL there with the cover frame in `content.thumbnail_url`. A post filed under a Threads topic tag also carries that tag name at `post.ext.topic_tag` (e.g. `bali`, `dokter gigi`) with its stable id at `post.ext.topic_tag_id`; both are absent on untagged posts. Quote posts are fully resolved: a post that quotes another usually carries no caption or media of its own, so the text and video shown on its page are returned under `post.ext.quoted_post` as `{ id, url, author, text, media_urls, thumbnail_url }`. That attachment belongs to a different account, so it is kept there rather than merged into `content`, and `post.content` always stays this post's own content. The field is absent on posts that are not quote posts. This is the only Threads endpoint that carries `engagement.views`. `post.id` is the same bare numeric id the list endpoints return for this post, and `post.url` is its canonical permalink, so a result from here joins directly against `/v1/threads/user/posts` and `/v1/threads/search`.
Last updated October 2026Maintained by the SocialCrawl team
Returns one Threads post's text, like, reply and repost counts, every carousel slide or video URL, author, creation time, and topic tag at post.ext.topic_tag.
Use it when you have a post URL and want that single post rather than a whole feed. If it is a quote post, the quoted post arrives at post.ext.quoted_post.
Searching 68 platforms in parallel
What can you do with the Post API?
The Post endpoint gives you structured Threads data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/threads/post?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FDZpPDXbCeTt&trim=true"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/threads/post",
params={
'url': 'https://www.threads.com/@zuck/post/DZpPDXbCeTt',
'trim': 'true',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/threads/post?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FDZpPDXbCeTt&trim=true",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters worth sending
trim=trueSame price, lighter payload: drops the bulky raw fields.
Parameters
| Parameter | Required | Description |
|---|---|---|
| url | Yes | Full URL of the Threads post, for example https://www.threads.com/@zuck/post/DZpPDXbCeTt. Both threads.com and threads.net are accepted. |
| trim | No | Ask the upstream for a stripped record. This is a real shape change, not just less whitespace: a trimmed row carries only the id, text, shortcode, like count, timestamp and author, so media, reply count, share count, view count, topic tag, pinned flag and quoted post all come back null. Same 1 credit either way, so send it only when the text and the like count are all you need. |
What does the Threads Post API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "threads",
"endpoint": "/v1/threads/post",
"data": {
"post": {
"id": "3920731152608519405",
"url": "https://www.threads.com/@zuck/post/DZpPDXbCeTt",
"content": {
"text": "500M monthly actives on Threads in less than 3 years. Thanks for making this platform what it is. 🙏",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "zuck",
"display_name": "Mark Zuckerberg",
"avatar_url": "https://scontent-lga3-2.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?stp=dst-jpg_s206x206_tt6&_nc_cat=107&ccb=7-5&_nc_sid=30ff31&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=E3aifIHJZHYQ7kNvwHuWW7a&_nc_oc=AdpjhFESFQQfE8x5uV0TlA2qQ-yjzwOolNaZA-eGk06Y-hxCg1G6WooazFRdQZq6Xww&_nc_zt=24&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LiiiQkkye2uN-XWkwjWWHg&_nc_ss=78289&oh=00_AQPH01WKjzClu5oRofta9R9zeC0SwGkEiuv-ZFikGjXAiA&oe=6AC595EB",
"verified": true
},
"engagement": {
"views": 2257829,
"likes": 18128,
"comments": 4730,
"shares": 586,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-06-16T10:59:56.000Z",
"ext": {
"published_at_epoch": 1781607596,
"quote_count": 250,
"topic_tag": null,
"reshare_count": 496,
"topic_tag_id": null
}
},
"computed": {
"engagement_rate": 0.010383,
"language": "en",
"content_category": "other",
"estimated_reach": 2709395
}
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T15:39:44.102Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Threads Post API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I get a Threads post's details with an API?
What engagement fields does the endpoint return?
Does it work for video posts and reshared content?
Can I trim the response to just the essentials?
How fast is the Threads Post API?
Ask AI about SocialCrawl
Ready to scrape Threads Post data?
Get your API key and start pulling Threads data in under 60 seconds.
