# Threads User Posts API

> Returns a list of posts from a specified Threads account. Accepts a user identifier and an optional pagination cursor to retrieve subsequent pages of data.

Source: https://www.sandbase.ai/apis/threads/web/user-posts
API reference: https://www.sandbase.ai/apis/threads/web/user-posts/docs

## Facts

- Provider: Threads
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/threads/web/user-posts`
- Price: $0.003 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- Capabilities: api, threads
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/threads/web/user-posts` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `user_id` | string | yes |  |
| `end_cursor` | string | no |  |

## FAQ

### How do I use the Threads User Posts API?

Send a POST request to https://api.sandbase.ai/v1/api/threads/web/user-posts with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Threads User Posts API cost?

$0.003 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the Threads User Posts API accept?

Required: user_id (string). Optional: end_cursor (string). The Parameters table and the Playground on this page list every field.

### What does the Threads User Posts API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Threads developer account or API key?

No. Threads User Posts runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Threads API access separately.

## README

### Threads User Posts API

Fetch posts for a target account using `user_id`. You can navigate multi-page timelines by providing an `end_cursor`.

#### Use cases

- Retrieve historical posts from a specific Threads profile.
- Page through account activity feeds using pagination tokens.
- Collect post content and metadata for social media monitoring.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/threads/web/user-posts" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "<user_id>"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `user_id` | string | Yes | User ID, for example: 63625256886, can be obtained from user profile API |
| `end_cursor` | string | No | Pagination cursor (optional), used to get next page data |

#### Notes

- `user_id` can be obtained from the user profile API.
- `end_cursor` is used to navigate to the next page of results.

#### Related APIs

- [Threads Post Detail](/model/threads/web/post-detail): Returns detailed information for a specific Threads post using its numeric ID.
- [Threads Post Detail (V2)](/model/threads/web/post-detail-v2): Returns detailed information for a specific Threads post.
- [Threads Profile Search](/model/threads/web/search-profiles): Searches Threads user profiles based on a specified text query string.