Skip to content

Threads Post Info

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.

Method Path Returns
POST /api/v1/threads/post Post details, its first page of replies, the author’s thread and optionally related posts
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 url as a query parameter or in the JSON body. If both are present, the query parameter wins. Unknown body properties are a 400.
  • 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 a 400.
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, 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.

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.

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.

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.

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
Terminal window
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"
{
"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
}