Threads API endpoint
Returns the public first page of posts for a topic tag. Discover the required `tag_id` and its canonical query `name` from `/threads/profile/{username}/topics` or a post's `topic` metadata. Topic results have no logged-out continuation cursor; `pagination_limited` marks the login wall for more results.
/threads/search/topicsMCP tool: threads_topic_search
q (required): canonical topic query from a profile topic's name or a post topic's search_query; 1 to 100 characters.tag_id (required): numeric Threads topic id from a profile topic or post's topic object.Returns the first public page of posts for the selected topic. Threads does not
provide a logged-out continuation cursor. pagination_limited is true when
Threads shows the login wall for more topic results.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Canonical topic query from a profile topic's `name` or a post topic's `search_query` | aithreads | |
| tag_id | string | Yes | Numeric Threads topic tag id | 18399895213044171 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/threads/search/topics?q=aithreads&tag_id=18399895213044171" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "aithreads",
"topic_id": "18399895213044171",
"items": [
{
"id": "123",
"code": "ABC123",
"url": "https://www.threads.com/@creator/post/ABC123",
"text": "Example post about AI",
"author": {
"username": "creator"
}
}
],
"has_more": false,
"pagination_limited": true
}
}Request schema
No body schema
Response schema
#/definitions/threads.topicSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | threads.TopicSearchResult | No | ||||
| data.has_more | boolean | No | Whether Threads reports another page. | |||
| data.items | array | No | Public threads matching the topic tag. Thread record, 26 fields: author, code, created_at, id, image_urls, is_reply, like_count, quote_count, reply_count, reply_to, repost_count, text and 3 more. Described under Search Threads API. | |||
| data.pagination_limited | boolean | No | True when Threads gates further results behind login or provides no supported continuation. | |||
| data.query | string | No | Search query used by the topic tag. | |||
| data.topic_id | string | No | Numeric Threads topic tag identifier. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid query or topic id | #/definitions/app.Response |
| 503 | Upstream error or parser drift | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/threads/search/topics?q=aithreads&tag_id=18399895213044171" \
-H "x-api-key: $CRAWLORA_API_KEY"