Endpoint Playground
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.
curl 'https://api.crawlora.net/api/v1/threads/search/topics?q=aithreads&tag_id=18399895213044171' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | aithreads | Canonical topic query from a profile topic's `name` or a post topic's `search_query` |
| tag_id | string | Yes | 18399895213044171 | Numeric Threads topic tag id |
{
"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
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.