Docs · Threads post
Threads post
The text, author, media and engagement of one public Threads post.
https://api.lurkapi.com/v1/threads/postWhen to use this
Pass a public threads.com or threads.net post URL. Returns the target post rather than suggested posts or its reply thread. Unknown or deleted posts return 404 only when Threads explicitly reports them unavailable. Login walls and incomplete pages return an upstream error.
Parameters
All parameters go in the query string.
| Parameter | Description |
|---|---|
urlstringrequired | Public post URL on threads.com or threads.net, containing /@<username>/post/<code>.
|
Example request
Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.
curl "https://api.lurkapi.com/v1/threads/post?url=https%3A%2F%2Fwww.threads.com%2F%40zuck%2Fpost%2FDd1MqfcG0aH" \
-H "x-api-key: YOUR_API_KEY"const params = new URLSearchParams({
url: "https://www.threads.com/@zuck/post/Dd1MqfcG0aH",
});
const res = await fetch(`https://api.lurkapi.com/v1/threads/post?${params}`, {
headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.media);import os
import requests
res = requests.get(
"https://api.lurkapi.com/v1/threads/post",
params={
"url": "https://www.threads.com/@zuck/post/Dd1MqfcG0aH",
},
headers={"x-api-key": os.environ["LURKAPI_KEY"]},
timeout=60,
)
data = res.json()
if not data["success"]:
raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["media"])Example response
A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….
Show the example response (1 KB)Hide
{
"success": true,
"credits_remaining": 99,
"credits_charged": 1,
"id": "3996155940894885511",
"code": "Dd1MqfcG0aH",
"url": "https://www.threads.com/@zuck/post/Dd1MqfcG0aH",
"text": "We believe superintelligence will create significant new opportunities f…",
"created_at": "2026-09-28T12:35:32.000Z",
"like_count": 2525,
"reply_count": 2393,
"repost_count": 155,
"quote_count": 148,
"author": {
"id": "63055343223",
"username": "zuck",
"name": "Mark Zuckerberg",
"is_verified": true,
"profile_pic_url": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-19/825322135_179893…"
},
"media": [],
"is_reply": false,
"is_pinned": false
}Response fields
Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.
Show all 25 fieldsHide
| Field | Type | Description |
|---|---|---|
| success | true | Always true here; errors have success: false. |
| credits_remaining | number | Your balance after this call. On anonymous playground calls: free tries left today. |
| credits_charged | number | Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1). |
| id | string | Numeric Threads post id, returned as a string. |
| code | string | Post shortcode used in its public URL. |
| url | string | Canonical public post URL on threads.com. |
| text | string | Post text; empty for posts that contain only media. |
| created_at | stringnullable | Publication time in ISO 8601; null when unknown. |
| like_count | numbernullable | Likes when fetched; null when Threads omits the count. |
| reply_count | numbernullable | Direct replies when fetched; null when unknown. |
| repost_count | numbernullable | Reposts when fetched; null when unknown. |
| quote_count | numbernullable | Quote posts when fetched; null when unknown. |
| author | objectnullable | Public author metadata; null when no usable author identity is included. |
| author.id | string | Numeric Threads account id, returned as a string. |
| author.username | string | Account username without @. |
| author.name | stringnullable | Display name; null when the public post omits it. |
| author.is_verified | booleannullable | Whether the author has a verified badge; null when unknown. |
| author.profile_pic_url | stringnullable | Profile picture URL; null when the public post omits it. |
| media | object[] | Attached media in source order; empty for text-only posts. |
| media[].type | string | Whether the URL is an image or a playable video file. |
| media[].url | string | Largest public image or video file URL supplied by Threads; these CDN links can expire. |
| media[].width | numbernullable | Media width in pixels; null when unknown. |
| media[].height | numbernullable | Media height in pixels; null when unknown. |
| is_reply | booleannullable | Whether this is a reply to another post; null when unknown. |
| is_pinned | booleannullable | Whether Threads marks the post as pinned; null when unknown. |
Caching and freshness
Responses are cached for up to 5 minutes, so a repeat call within that window can return the same data. It still costs 1 credit.
Errors
Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.
| Status | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No API key. Send it in the x-api-key header. |
| 401 | invalid_api_key | The key is unknown or was revoked. |
| 402 | insufficient_credits | Not enough credits for this call. Buy a pack or wait for tomorrow's top-up. |
| 403 | not_public | The platform confirmed this account or content isn't available to logged-out visitors. Use a publicly visible target. |
| 404 | not_found | The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked. |
| 405 | method_not_allowed | Endpoints take GET with query params. |
| 429 | rate_limited | Too many calls at once. Wait for the retry-after seconds, then retry. |
| 500 | internal_error | Something broke on our side. Retry; 5xx errors are free. |
| 502 | upstream_error | The platform didn't give a usable answer. Retry; 5xx errors are free. |
| 503 | upstream_busy | All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free. |
| 504 | upstream_timeout | The platform took over 30 seconds to answer. Retry; timeouts are free. |
Use it in Claude
Once LurkAPI is connected to Claude, this endpoint is the threads_post tool. Ask in plain English, for example:
Use LurkAPI's threads_post with url "https://www.threads.com/@zuck/post/Dd1MqfcG0aH" and summarize what you find.Claude calls threads_post with arguments like these, and each call costs 1 credit:
{
"url": "https://www.threads.com/@zuck/post/Dd1MqfcG0aH"
}Tool results skip nulls and empty lists to save tokens.