Threads API endpoint
Returns the public replies currently exposed to logged-out visitors. The response identifies when Threads reports additional replies but withholds a usable continuation cursor.
/threads/post/{username}/{code}/repliesMCP tool: threads_post_replies
username (required): author username.code (required): post code from a Threads post URL.Returns replies visible to logged-out visitors. Items retain their actual author and attached topic metadata when available. Threads can report that additional replies exist without providing a usable public continuation cursor; in that case has_more and pagination_limited are true and next_cursor is omitted.
| Field | Filled in, of 33 checked | Values in the sample |
|---|---|---|
| id | 33 | |
| code | 33 | |
| url | 33 | threads.com |
| text | 31 | |
| author | 33 | |
| created_at | 33 | 2026-07-09 to 2026-07-24 |
| like_count | 28 | 1 to 1,053, median 11 |
| reply_count | 17 | 1 to 100, median 1 |
| repost_count | 5 | 1 to 64, median 3 |
| quote_count | 3 | 1 to 15, median 1 |
| is_reply | 33 | true in 33 of 33 |
| reply_to | 33 | |
| image_urls | 3 | median 1 entry |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| username (path) | string | Yes | Threads username | zuck | |
| code (path) | string | Yes | Threads post code | DakyAavlKLZ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/threads/post/zuck/DakyAavlKLZ/replies" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"username": "zuck",
"code": "ABC123",
"items": [
{
"id": "456",
"code": "DEF456",
"url": "https://www.threads.com/@someone/post/DEF456",
"text": "Example reply",
"author": {
"username": "someone"
},
"is_reply": true
}
],
"has_more": true,
"pagination_limited": true
}
}Request schema
No body schema
Response schema
#/definitions/threads.repliesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | threads.RepliesResult | No | ||||
| data.code | string | No | ||||
| data.has_more | boolean | No | Whether Threads reports more replies beyond this page. | |||
| data.items | array | No | Replies to the post, each as a thread. | |||
| data.items[].author | object | No | Account that posted the thread. | |||
| data.items[].author.id | string | No | Threads user ID of the author. | |||
| data.items[].author.name | string | No | Display name of the author. | |||
| data.items[].author.username | string | No | Threads username of the author. | |||
| data.items[].code | string | No | ||||
| data.items[].created_at | string | No | Time the thread was posted, in UTC (RFC 3339). | |||
| data.items[].id | string | No | Threads post ID. | |||
| data.items[].image_urls | array | No | URLs of the images attached to the thread. | |||
| data.items[].is_reply | boolean | No | Whether the thread is a reply to another thread. | |||
| data.items[].like_count | integer | No | Number of likes on the thread. | |||
| data.items[].quote_count | integer | No | Number of times the thread was quoted. | |||
| data.items[].reply_count | integer | No | Number of replies to the thread. | |||
| data.items[].reply_to | string | No | Username of the account this thread replies to. | |||
| data.items[].repost_count | integer | No | Number of times the thread was reposted. | |||
| data.items[].text | string | No | Text of the thread. | |||
| data.items[].topic | object | No | Public topic/community tag attached to the thread, when present. | |||
| data.items[].topic.community_emoji | string | No | Community reaction emoji, when present on a post tag. | |||
| data.items[].topic.community_favicon_url | string | No | Community icon URL, when present. | |||
| data.items[].topic.display_name | string | No | Topic label shown in Threads. | |||
| data.items[].topic.id | string | No | Numeric Threads topic tag identifier. | |||
| data.items[].topic.is_community | boolean | No | Whether Threads identifies this topic as a community. | |||
| data.items[].topic.name | string | No | Canonical topic query returned on profile topic lists. | |||
| data.items[].topic.search_query | string | No | Query to pair with ID when calling the topic search endpoint. | |||
| data.items[].topic.tag_cluster_name | string | No | Topic cluster or category label, when present. | |||
| data.items[].url | string | No | URL of the thread on Threads. | |||
| data.items[].video_urls | array | No | URLs of the videos attached to the thread. | |||
| data.next_cursor | string | No | Cursor to pass to fetch the next page of replies. | |||
| data.pagination_limited | boolean | No | True when more replies exist but Threads gives no usable cursor to fetch them. | |||
| data.username | string | No | Username of the post's author. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid username or post code | #/definitions/app.Response |
| 404 | Post not found | #/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/post/zuck/DakyAavlKLZ/replies" \
-H "x-api-key: $CRAWLORA_API_KEY"