POST /api/v1/threads/post — 1 credit per request
Look up a public Threads post by URL. Returns the post (text, author, like, view, reply, repost and quote counts, time, image and video links, link preview, topic tag) together with the first page of its replies, the posts the author added under it as a thread and, when you ask, the posts Threads relates to it. Every post comes in Threads’ own post shape. Send the URL as a query parameter or in the JSON body.
Endpoint
Section titled “Endpoint”| Method | Path | Returns |
|---|---|---|
| POST | /api/v1/threads/post |
Post details, its first page of replies, the author’s thread and optionally related posts |
Request & Response
Section titled “Request & Response”Request
Section titled “Request”| Name | Where | Type | Required | Description |
|---|---|---|---|---|
url |
query or body | string (max 300) | Yes | A Threads post address: threads.com, www.threads.com, threads.net or www.threads.net, with the path /@<username>/post/<code>. The scheme is optional. A query string or fragment on the address is ignored |
include_related |
query | boolean | No | true adds result.relatedPosts. No extra charge, and the answer can take a little longer. A post fetched in the last 15 minutes without them is fetched again, and charged as a new lookup |
- Send
urlas a query parameter or in the JSON body. If both are present, the query parameter wins. Unknown body properties are a400. - Threads ignores the username in a post address, so the same post under two usernames is one lookup, one cache entry and one charge.
- A profile address, a short
/t/…address, a port, or a host other than the four above is a400.
Response body
Section titled “Response body”| Field | Type | Description |
|---|---|---|
requestId |
string | Opaque ID for this request (req_…). Quote it when reporting a problem |
shortcode |
string | The post’s short code this lookup was for, resolved from whatever you sent |
status |
string | "success" on every 200 |
coalesced |
boolean | true if this request joined a fetch for the same post that was already under way |
cached |
boolean | true if answered from a fetch of the last 15 minutes. Free if your key already paid for this post |
result.post |
object | The post, see below |
result.comments |
array | Up to 10 top-level replies, most relevant first, each a post in the same shape. Empty when comments_status is not ok, and also for a post nobody replied to |
result.threadItems |
array | The posts the author added under this one as a thread, same shape, read with the replies at no extra cost. Empty when there are none |
result.relatedPosts |
array | With include_related=true, the posts Threads shows under this one to a visitor who is not logged in, same shape. Empty otherwise |
result.comments_status |
string | Whether the replies were read, see below |
result.related_posts_status |
string | Why relatedPosts is what it is, see below |
finishReason |
string | Empty on a freshly fetched answer, absent on a cached one. Ignore it on a 200 |
success |
boolean | true on every 200 |
credits_charged |
integer | What this request cost. 0 for a post your key already paid for, and 0 when the replies could not be read |
credits_remaining |
integer | Your balance after this request |
cached_at |
string | UTC time of the cached answer. Present only on a cached answer |
The post object
Section titled “The post object”The post, each reply, each thread item and each related post are Threads’ own post object, with Threads’ key names and nesting. These are the fields most callers need.
| Field | Type | Description |
|---|---|---|
id, pk, code |
string | The post’s identifiers. code is the short code in the address |
user |
object | The author: pk, id, username, full_name (absent when there is none), profile_pic_url, is_verified, text_post_app_is_private and has_onboarded_to_text_post_app |
caption |
object or null |
text, and its pk. null for a post with no text |
like_count |
integer or null |
null is not zero: Threads sent no count |
view_counts |
integer | Views, as Threads counts them. On the post you asked about only, and only when Threads sends it |
text_post_app_info.direct_reply_count |
integer or null |
The post’s true number of direct replies, not the length of comments |
text_post_app_info.repost_count, quote_count, reshare_count |
integer or null |
Reposts, quote posts, and shares counted apart from reposts |
text_post_app_info.text_fragments.fragments |
array | The text in pieces: plaintext, or a link with its address |
text_post_app_info.tag_header |
object or null |
The post’s topic tag |
text_post_app_info.link_preview_attachment |
object or null |
The link preview card, when the post has one |
text_post_app_info.is_reply, reply_to_author, root_post_author |
Set on a reply, null on the post itself |
|
taken_at |
integer | Unix seconds |
media_type |
integer | Threads’ own code: 19 for a text post, 1 for an image, 2 for a video |
image_versions2.candidates |
array | The image at each size Threads lists, each { height, url, width } (for a video, its cover). Empty for a text post. A multi-image post returns the first image only |
video_versions |
array or null |
The video renditions, each with Threads’ code (type) and a url. No width or height: Threads sends none. null without a video |
has_audio |
boolean or null |
null for a post with no video |
original_width, original_height |
integer | The media’s size in pixels |
Keys whose filled-in shape has not been seen yet (audio, carousel_media, transcription_data, share_info.quoted_post and share_info.reposted_post, among a few others) are always present and null for now. A count Threads did not send is null, not absent.
Addresses in profile_pic_url, image_versions2.candidates[].url and video_versions[].url are Threads’ own and expire. Download what you need to keep.
comments_status
Section titled “comments_status”| Value | Meaning | Charged |
|---|---|---|
ok |
The replies were read. An empty comments then means the post has no replies |
Yes |
unavailable |
Threads would not give the replies on this try. The post itself is good | No |
query-not-found |
Threads changed the page and no replies request could be made | No |
shape-changed |
The replies request answered in a shape we do not read | No |
hidden |
The post has replies, but Threads shows none of them to a logged-out visitor | No |
A post is sold together with its replies. When the replies could not be read you still get the post, but the 200 is free. That answer is remembered for 1 minute only, so asking again after a minute tries the replies again, and is charged once if it succeeds.
related_posts_status
Section titled “related_posts_status”| Value | Meaning |
|---|---|
not-requested |
include_related was not set; relatedPosts is empty |
ok |
The related posts were read. An empty relatedPosts then means Threads relates no posts to this one |
unavailable |
Asked for, but they could not be read this time, or your request joined a fetch already under way without them. Ask again |
Related posts never change what you are charged: a 200 without them is charged by comments_status like any other.
Caching and cost
Section titled “Caching and cost”A fresh answer is shared across keys for 15 minutes (1 minute for a post without its replies, 1 hour for a post that does not exist). Only a 200 is charged, and only when the replies were read. Asking again for a post your key already paid for is free while it is cached, except that a post cached without related posts is fetched again, and charged, when you ask for them. A 403, 404, 429 or 503 is never charged, and resubmitting after a 503 never charges twice.
Errors
Section titled “Errors”| Status | When | What to do |
|---|---|---|
400 |
The URL is missing or not a Threads post address | Fix the request |
401 |
No API key, or an unknown one | Check your key |
402 |
Your balance cannot cover this plus your unfinished lookups | Buy credit |
403 |
Threads refused this post to us (a login wall) | Not charged. Do not retry blindly |
404 |
No such post, or one Threads does not show a logged-out visitor (deleted, private, restricted) | Not charged. A deleted post and a private one look the same |
429 |
Rate limit, too many unfinished lookups, or too many posts that do not exist (30 in 15 minutes by default) | Slow down. Not charged |
503 |
No answer in time, Threads failing, the service paused after repeated refusals, or the endpoint switched off | Not charged. Resubmit after the Retry-After delay |
curl -X POST "https://api.megomi.my.id/api/v1/threads/post?url=https://www.threads.com/@instagram/post/De2ct9AiRkL" \ -H "x-api-key: YOUR_API_KEY"const params = new URLSearchParams({ url: "https://www.threads.com/@instagram/post/De2ct9AiRkL" });const res = await fetch(`https://api.megomi.my.id/api/v1/threads/post?${params}`, { method: "POST", headers: { "x-api-key": process.env.MEGOMI_API_KEY }, signal: AbortSignal.timeout(60_000),});const data = await res.json();import requests
res = requests.post( "https://api.megomi.my.id/api/v1/threads/post", params={"url": "https://www.threads.com/@instagram/post/De2ct9AiRkL"}, headers={"x-api-key": "YOUR_API_KEY"}, timeout=60,)print(res.json())<?php$url = "https://api.megomi.my.id/api/v1/threads/post?" . http_build_query(["url" => "https://www.threads.com/@instagram/post/De2ct9AiRkL"]);$ch = curl_init($url);curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);curl_setopt($ch, CURLOPT_TIMEOUT, 60);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);echo curl_exec($ch);q := url.Values{}q.Set("url", "https://www.threads.com/@instagram/post/De2ct9AiRkL")req, _ := http.NewRequest("POST", "https://api.megomi.my.id/api/v1/threads/post?"+q.Encode(), nil)req.Header.Set("x-api-key", "YOUR_API_KEY")client := &http.Client{Timeout: 60 * time.Second}resp, _ := client.Do(req){ "requestId": "req_9f1kQ3zP7mLxA2dR", "shortcode": "De2ct9AiRkL", "status": "success", "coalesced": false, "cached": false, "result": { "post": { "id": "4014522421033376011_63404918397", "pk": "4014522421033376011", "code": "De2ct9AiRkL", "user": { "pk": "63404918397", "id": "63404918397", "username": "user_1", "full_name": "Sanitized Name", "profile_pic_url": "https://scontent.example.invalid/1.jpg", "is_verified": false, "text_post_app_is_private": false, "has_onboarded_to_text_post_app": true }, "caption": { "text": "Sanitized text", "pk": "17968136457193617" }, "like_count": 494, "text_post_app_info": { "direct_reply_count": 52, "repost_count": 26, "quote_count": 4, "reshare_count": 14, "is_reply": false, "tag_header": null, "link_preview_attachment": null }, "taken_at": 1792788409, "has_audio": true, "media_type": 2, "image_versions2": { "candidates": [ { "height": 1136, "url": "https://scontent.example.invalid/2.jpg", "width": 640 } ] }, "video_versions": [ { "type": 101, "url": "https://scontent.example.invalid/13.jpg" } ], "original_width": 720, "original_height": 1280 }, "comments": [ { "id": "4014524322312469643_49586759406", "pk": "4014524322312469643", "code": "De2dJntmbyL", "user": { "pk": "49586759406", "username": "user_2", "is_verified": false }, "caption": { "text": "Sanitized text" }, "taken_at": 1792788614 } ], "threadItems": [], "relatedPosts": [], "comments_status": "ok", "related_posts_status": "not-requested" }, "finishReason": "", "success": true, "credits_charged": 1, "credits_remaining": 249}{ "status": 400, "title": "Bad Request", "detail": "url is required: send the post's URL as the url query parameter or as url in the JSON body" }{ "status": 404, "title": "Not Found", "detail": "the source reports no such post (deleted, or never existed); you were not charged. This answer is cached for an hour", "requestId": "req_5mPq1XwK8jVcT4nR", "finishReason": "not-found"}{ "status": 503, "title": "Service Unavailable", "detail": "no data fetched within 45s; you were not charged. The lookup is still running: submitting the same request again shortly may return it from cache, and is never charged twice", "requestId": "req_1qLr6PxV8nWtE3sJ", "finishReason": "no-data-fetched"}