# Threads API — UnifAPI > Posts, replies, reposts, search. Read Meta's Threads as unified JSON: profiles, posts by user or URL, replies, reposts, and recent, top and profile search. - Category: Social platforms - API base URL: https://api.unifapi.com - Auth: `Authorization: Bearer ` (OAuth recommended for MCP clients) - MCP server: https://mcp.unifapi.com - Developer docs: https://docs.unifapi.com/api/threads - OpenAPI spec: https://unifapi.com/openapi.json - HTML page: https://unifapi.com/apis/threads - Full catalog: https://unifapi.com/apis.md ## Agent workflows - Fetch public Threads profiles, posts, replies, reposts, and search results for lightweight social research. - Compare recent, top, and profile search results when an agent needs text-first signal from Meta's public social graph. - Join Threads records with X, Reddit, TikTok, or YouTube data in one Skills workflow without changing auth, pagination, or error handling. ## Endpoints (9) Every endpoint returns the UnifAPI JSON envelope (`request_id`, `data`, `pagination` on lists, `billing`) and bills max(records × credits per record, minimum) in credits. ### Get a Threads post by URL `GET /threads/posts` Returns one Threads post by URL with its author, media, counts, the rest of its thread, replies and related posts. Returns `not_found` when the post does not exist. - Price: 1 credit per record, minimum 3 credits ($0.003) per call - Required: `url` (query) - Details: https://unifapi.com/apis/threads/posts/get - Docs: https://docs.unifapi.com/api/threads/posts/get ### Resolve a Threads post URL into its numeric media ID `GET /threads/resolve/media-id` Convert a public Threads post URL into its post code and numeric `media_id`. Accepts threads.com and threads.net links. Useful for normalizing saved links and matching identifiers across datasets. This identifier conversion does not verify that the post still exists or is publicly accessible. - Price: 1 credit per record, minimum 1 credit ($0.001) per call - Required: `url` (query) - Details: https://unifapi.com/apis/threads/resolve/media-id/get - Docs: https://docs.unifapi.com/api/threads/resolve/media-id/get ### Search Threads users by keyword `GET /threads/search/profiles` Search Threads accounts by keyword, returning matching public profiles. Useful for creator discovery, audience research, and finding accounts active on a topic. Bio and follower count can be empty in search results; fetch the profile for them. - Price: 1 credit per record, minimum 3 credits ($0.003) per call - Required: `q` (query) - Details: https://unifapi.com/apis/threads/search/profiles/get - Docs: https://docs.unifapi.com/api/threads/search/profiles/get ### Search recent Threads posts `GET /threads/search/recent` Search recent Threads posts by keyword, returning matches newest-first as a cursor-paginated list. Useful for tracking brand mentions, keywords, and breaking conversations in near real time. - Price: 1 credit per record, minimum 1 credit ($0.001) per call - Required: `q` (query) - Details: https://unifapi.com/apis/threads/search/recent/get - Docs: https://docs.unifapi.com/api/threads/search/recent/get ### Search top Threads posts `GET /threads/search/top` Search Threads posts by keyword, ranked by engagement, returning the top matches as a cursor-paginated list. Useful for surfacing the most resonant content on a topic. - Price: 1 credit per record, minimum 1 credit ($0.001) per call - Required: `q` (query) - Details: https://unifapi.com/apis/threads/search/top/get - Docs: https://docs.unifapi.com/api/threads/search/top/get ### Get a Threads user profile by username `GET /threads/users/{username}` Return a Threads user's public profile by username, including display name, bio, follower count, and verification status. Useful as the entry point for any account-level research. - Price: 1 credit per record, minimum 3 credits ($0.003) per call - Required: `username` (path) - Details: https://unifapi.com/apis/threads/users/username/get - Docs: https://docs.unifapi.com/api/threads/users/username/get ### List Threads posts authored by a user `GET /threads/users/{username}/posts` Return the posts authored by a Threads user, by username, as a cursor-paginated list. Useful for profiling a creator's content, monitoring a brand, or building an archive. - Price: 1 credit per record, minimum 1 credit ($0.001) per call - Required: `username` (path) - Details: https://unifapi.com/apis/threads/users/username/posts/get - Docs: https://docs.unifapi.com/api/threads/users/username/posts/get ### List Threads replies authored by a user `GET /threads/users/{username}/replies` Return the replies a Threads user has authored, by username, as a cursor-paginated list. Useful for understanding how an account engages in conversation beyond its own posts. - Price: 1 credit per record, minimum 1 credit ($0.001) per call - Required: `username` (path) - Details: https://unifapi.com/apis/threads/users/username/replies/get - Docs: https://docs.unifapi.com/api/threads/users/username/replies/get ### List Threads reposts by a user `GET /threads/users/{username}/reposts` Return the posts a Threads user has reposted, by username, as a cursor-paginated list. Useful for inferring an account's interests and the content it amplifies. - Price: 1 credit per record, minimum 1 credit ($0.001) per call - Required: `username` (path) - Details: https://unifapi.com/apis/threads/users/username/reposts/get - Docs: https://docs.unifapi.com/api/threads/users/username/reposts/get ## Related APIs - [Reddit API](https://unifapi.com/apis/reddit/index.md) — Subreddits, posts, comments, feeds, search - [Twitter / X API](https://unifapi.com/apis/twitter/index.md) — Users, posts, search, trends, lists, communities - [Facebook API](https://unifapi.com/apis/facebook/index.md) — Pages, posts, reels, groups, events, Marketplace, Ad Library - [YouTube API](https://unifapi.com/apis/youtube/index.md) — Channels, videos, comments, captions, playlists, hashtags, search, trending - [Bluesky API](https://unifapi.com/apis/bluesky/index.md) — Profiles, posts, replies - [Instagram API](https://unifapi.com/apis/instagram/index.md) — Profiles, posts, reels, stories, comments, audio, search