Threads API
# Threads Public API Threads Public API is a REST API wrapper built on top of the official Meta Threads Graph API. It provides exchange-ready endpoints for retrieving Threads user profiles, public posts, repost-like items, replies, post details, post replies, conversations, keyword search results, recent search results, and exact profile lookups. The API is designed for developers who need a…
Threads API endpoints
| Method | Endpoint | Description |
|---|---|---|
| System | ||
| GET |
healthCheck /health |
Check whether the API is online and which Threads Graph API base URL is configured. This endpoint does not call Meta and does not require a Threads access token. |
| User | ||
| GET |
getUserInfo /v1/user/info |
Retrieve public profile information for an exact Threads username. This endpoint maps to the official Threads public profile lookup capability. It requires a valid Threads OAuth… |
| GET |
getUserReplies /v1/user/{user_id}/replies |
Retrieve replies authored by a Threads user. The response is paginated and can include reply metadata such as root post, replied-to post, reply audience, hide status, and… |
| GET |
getUserInfoById /v1/user/info/{user_id} |
Retrieve profile information for a Threads user ID. Use this endpoint when you already know the Threads user ID and want profile metadata returned by the official Threads API.… |
| GET |
getUserReposts /v1/user/{user_id}/reposts |
Retrieve repost-style items for a Threads user. The official Threads API does not expose a dedicated public repost feed. This endpoint reads the user's post feed and returns… |
| GET |
getUserPosts /v1/user/posts |
Retrieve public posts for an exact Threads username. The response is paginated. Use `limit`, `before`, and `after` to navigate through results. The optional `since` and `until`… |
| Post | ||
| GET |
getRelatedPosts /v1/post/{post_id}/related |
Retrieve posts related to a Threads post through the official conversation feed. Threads does not expose a generic "related posts" endpoint. This API maps related posts to the… |
| GET |
getPostDetail /v1/post/detail |
Retrieve details for a Threads post. Pass a Threads media ID with `post_id`. You may also provide a Threads post URL, in which case the API first attempts to resolve it to a… |
| GET |
getPostIdByUrl /v1/post/id-by-url |
Resolve a Threads post URL to a Threads media ID when possible. The endpoint parses URLs such as `https://www.threads.net/@username/post/shortcode`. When `resolve=true`, it scans… |
| GET |
getPostComments /v1/post/{post_id}/comments |
Retrieve comments for a Threads post. Threads calls comments "replies" in the official API. This endpoint exposes a developer-friendly comments route while mapping internally to… |
| Search | ||
| GET |
searchProfiles /v1/search/profiles |
Look up a Threads profile by exact username. The official Threads API does not expose broad profile keyword search. This endpoint therefore performs exact username lookup only.… |
| GET |
searchTop /v1/search/top |
Search Threads for top results matching a keyword or topic tag. Use `search_mode=KEYWORD` for normal keyword search or `search_mode=TAG` for topic tag search. Access depends on… |
| GET |
searchRecent /v1/search/recent |
Search Threads for recent results matching a keyword or topic tag. Use this endpoint when freshness matters more than ranking. Pagination and available fields depend on the… |
Threads API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $19 / month | — |
|
| ULTRA | $79 / month | — |
|
| MEGA | $249 / month | — |
|