Threads API endpoint
Returns one public Threads post by `username` (with or without a leading `@`) and the post `code` from its URL. The response has the post text, canonical URL, preview image URL, and the author's id, name and username. Replies and logged-in fields are not included. An unavailable post returns 404.
/threads/post/{username}/{code}MCP tool: threads_post
Path parameters:
username: required. Threads username, with or without a leading @.code: required. The alphanumeric post code from a Threads post URL.Notable response behavior:
| Field | In the sample | Value in the sample |
|---|---|---|
| code | Has a value | |
| url | Has a value | threads.com |
| text | Has a value | 156 characters |
| image_url | Has a value | scontent-sof1-1.cdninstagram.com |
| author.username | Has a value | |
| author.name | Has a value |
| 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" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"code": "DakyAavlKLZ",
"url": "https://www.threads.com/@zuck/post/DakyAavlKLZ",
"text": "Example public post text",
"author": {
"username": "zuck",
"name": "Mark Zuckerberg"
}
}
}Request schema
No body schema
Response schema
#/definitions/threads.postResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | threads.Post | No | ||||
| data.author | threads.Author | No | ||||
| data.author.id | string | No | Threads user ID of the author. | |||
| data.author.name | string | No | Display name of the author. | |||
| data.author.username | string | No | Threads username of the author. | |||
| data.code | string | No | ||||
| data.image_url | string | No | ||||
| data.text | string | No | ||||
| data.url | string | No | ||||
| 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" \
-H "x-api-key: $CRAWLORA_API_KEY"