# Threads Post API (https://www.socialcrawl.dev/platforms/threads/post)

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

TL;DR: `GET /v1/threads/post` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

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

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/threads/post" \
  --data-urlencode "url=https://www.threads.com/@zuck/post/DZpPDXbCeTt" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Threads post's details with an API?

Send a GET request to /v1/threads/post with the full post URL in the url parameter. SocialCrawl returns the post text, like count, reply count, repost count, view count, media attachments, and author information.

### What engagement fields does the endpoint return?

The response breaks engagement into likes, comments (replies), shares (reposts), saves (reshares), and views. Every field lives under the unified post.engagement object so you can compare engagement across platforms with the same code.

### Does it work for video posts and reshared content?

Yes. Video posts return the same core fields plus thumbnail, duration, and view count. Reshared posts include the original author info so you can trace the post back to its source without extra lookups.

### Can I trim the response to just the essentials?

Yes. Pass trim=true and the endpoint returns a compact payload with only the core fields. Handy for dashboards and feeds where you display a summary and only fetch the full post on demand.

### How fast is the Threads Post API?

Most requests return JSON in 1–3 seconds. The endpoint uses the post cache category, so repeat requests for the same post URL come back faster from the SocialCrawl cache with no extra credit charge on cache hits.

See the full Threads API: https://www.socialcrawl.dev/platforms/threads

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to fetch a Threads post's details with an API
- What does the SocialCrawl Threads Post API return?