# Threads Search API (https://www.socialcrawl.dev/platforms/threads/search)

> Searches Threads for posts matching a keyword query. Returns a list of matching posts with text content, like counts, author info, and creation timestamps. Posts filed under a Threads topic tag also carry that tag name at `post.ext.topic_tag` (e.g. `bali`, `dokter gigi`) with its stable id at `post.ext.topic_tag_id`, so you can group or filter results by topic client-side; both are absent on untagged posts, which are the majority. Threads exposes no tags-only search mode upstream, so this stays a keyword query. Each response is one result window (typically 15-20 posts); page deeper by sending back pagination.next_cursor as cursor, or set limit (1-100) to have the API walk multiple windows server-side and return up to that many unique posts in a single call, billed per window consumed (1 credit each, unused window budget refunded). start_date and end_date bound the search to a period; the cursor walk stays inside those bounds.

TL;DR: `GET /v1/threads/search` 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 |
| --- | --- | --- |
| `query` | yes | Search keyword or phrase to find Threads posts |
| `start_date` | no | Inclusive start of the search period (YYYY-MM-DD). Pagination never walks past it. |
| `end_date` | no | Inclusive end of the search period (YYYY-MM-DD). Pagination starts here and walks back in time. |
| `trim` | no | Set to true for a trimmed down version of the response |
| `cursor` | no | Opaque cursor from a prior response's pagination.next_cursor to fetch the next (older) result window. |
| `limit` | no | Return up to this many unique posts in one call (1-100). The API walks result windows server-side until it has collected this many (or the query runs dry), billing 1 credit per window consumed (about 15-20 posts each) and refunding the unused budget. Omit for a single window. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/threads/search?query=artificial%20intelligence" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search Threads posts by keyword?

Send a GET request to /v1/threads/search with a query parameter. SocialCrawl returns an array of matching posts with text content, like counts, author info, and creation timestamps, ranked by Threads relevance.

### Can I filter search results by date range?

Yes. Pass optional start_date and end_date parameters to constrain the search window. Useful for tracking mentions during a campaign, monitoring how a brand narrative evolves, or building time-bounded reports.

### What data does each search result include?

Each result comes with the post id, text, like count, reply count, repost count, view count, author handle and display name, verification status, and the publish timestamp, all in a unified schema.

### How is this different from searching users?

The search endpoint finds posts matching your keyword; search/users finds user accounts matching a keyword. Use search for social listening and content monitoring; use search/users for creator and account discovery.

### How much does the Threads Search API cost?

Each search request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, enough to run 100 Threads keyword searches before you pay anything.

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 search Threads posts by keyword with an API
- What does the SocialCrawl Threads Search endpoint return?