Threads

Threads Post API

Fetch a single Threads post as JSON, by post id or by its threads.net URL - text, like / reply / repost counts, publish time, media type, cover image, playable video URL and the author. Costs 2 credits flat: this endpoint has no username form, so the Threads handle surcharge never applies here.

POST/api/v1/threads/post

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

post_idstring

Numeric Threads post id, non-empty. This is the pk that comes back as post_id on User Posts, User Replies and Post Comments - not the shortcode in the browser URL. Provide post_id or url.

Example: 3959219802799869824

urlstring (url)

Full threads.net post URL, as an alternative to post_id. Must be a valid absolute URL or the request is rejected before anything is billed. Send this form when all you have is a shortcode - a URL is served by a different upstream reader than a bare id, so there is no need to convert the shortcode yourself. Provide post_id or url; sending neither is a 400.

Example: https://www.threads.net/@natgeo/post/Dbx-W8NlA-A

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

post = client.threads.post(post_id="3959219802799869824")

# Or straight from a link you already have
# post = client.threads.post(url="https://www.threads.net/@natgeo/post/Dbx-W8NlA-A")

p = post["data"]
print(p["text"], p["like_count"], p["reply_count"], p["user"]["user_id"])

Response

"post_id": "3959219802799869824",

"code": "Dbx-W8NlA-A",

"text": "On International Cat Day, let's all come together and wish these felines a very happy pspspsps.",

"taken_at": 1786195805,

"like_count": 281,

"reply_count": 12,

"repost_count": 30,

"media_type": 1,

"cover_url": "https://scontent-sea1-1.cdninstagram.com/v/t51.82787-15/767743332_17979788103110603_5470288836901772947_n.jpg?stp=dst-...",

"video_url": null,

"response_time": 1903,

"credits_used": 2,

"credits_remaining": 998

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") post = client.threads.post(post_id="3959219802799869824") # Or straight from a link you already have # post = client.threads.post(url="https://www.threads.net/@natgeo/post/Dbx-W8NlA-A") p = post["data"] print(p["text"], p["like_count"], p["reply_count"], p["user"]["user_id"])