Threads API reference
Get public Threads profiles, posts with likes and replies, tag volumes, search results and profile feeds as clean JSON. Send a handle, a post link or a tag. No Instagram or Threads login.
The Threads API has 9 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Threads in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are handle, post_id and post_url. Every endpoint costs 0.75 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
threads.profile |
Get a public profile from its handle: name, bio, followers, following and how many threads it has posted. | 0.75 credits |
threads.post |
Get one post from its link, or its handle and ID: text, likes, replies, reposts, quotes and post time. | 0.75 credits |
threads.profile.feed |
List a profile's recent threads, replies, media posts or reposts, with text, likes, replies and post time. | 0.75 credits |
threads.tag |
Get a topic tag's volume: how many threads use it in total and how many recently. | 0.75 credits |
threads.search |
Search Threads by keyword and get the matching posts with their links. | 0.75 credits |
threads.search.users |
Find public profiles that match a search. | 0.75 credits |
threads.post.replies |
Get the links to the public replies on a post. | 0.75 credits |
threads.user.threads |
List the links to a profile's media posts. | 0.75 credits |
threads.home.feed |
Get the posts Threads shows on its public home page. | 0.75 credits |
What to know
- Counts as Threads shows them Followers and tag volumes come rounded the way Threads shows them, such as 38.4M, at the moment of the call.
- Some endpoints return links Search, replies, media posts and the home feed return post or profile links. Open any of them with the post or profile endpoint for the details.
- Recent posts Feeds and searches return what Threads shows first, not a profile's full history.
- Tags give volume The tag endpoint tells you how many threads use a tag; search finds the posts themselves.
Something missing or unclear? Ask the team that builds the Threads endpoints.