# Threads User Posts API (https://www.socialcrawl.dev/platforms/threads/user-posts)

> Returns the most recent posts from a Threads user (typically ~15 per call). Each post includes the text content, like count, reply count, repost count, media attachments, and creation timestamp. Pagination is not currently supported on this endpoint — the upstream provider returns a single page. For deeper history, use `/v1/threads/search` with a date window or `/v1/search/everywhere`.

TL;DR: `GET /v1/threads/user/posts` 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 |
| --- | --- | --- |
| `handle` | yes | Threads username without the @ symbol |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/threads/user/posts?handle=zuck" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I use the Threads User Posts API to list a user's feed?

Send a GET request to /v1/threads/user/posts with the handle parameter (no @ symbol). SocialCrawl returns an array of recent posts including text, like count, reply count, repost count, media attachments, and publish timestamp.

### What fields does each Threads post include?

Every post has its id, text content, like count, reply count, repost count, view count, media URLs, author info, and published_at timestamp. Field names stay consistent across every SocialCrawl platform.

### Can I trim the response for lean JSON?

Yes. Pass trim=true and the endpoint returns a compact payload with only the essential fields. Useful when you are embedding Threads posts at scale and want to minimise bandwidth and parsing overhead.

### Does the endpoint return video and image posts?

Yes. Both image and video posts appear in the array with their media URLs and thumbnails. Videos include view counts and, when available, duration — all normalised into the same content.media fields as other platforms.

### How fresh is the post data?

Responses reflect what is publicly visible on Threads at request time. SocialCrawl caches under the post category for a short window so repeated calls for the same handle return instantly without an extra upstream fetch.

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 list Threads user posts with an API
- What data does the SocialCrawl Threads user/posts endpoint return?