Social platformsLive

Threads API for AI agents

Read Meta's Threads as unified JSON: profiles, posts by user or URL, replies, reposts, and recent, top and profile search.

Using ChatGPT, Claude Code or another client? See the setup steps

Agent workflows

Use Threads records as evidence, not glue code.

UnifAPI keeps the public Threads surface discoverable through MCP and callable over HTTP. Agents can inspect the schema, fetch only the records needed for the task, and return the result with request, pagination, and billing metadata intact.

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.

Run it

Agents & Skills that use the Threads API

You rarely call an API by hand. These prebuilt agents and skills already read Threads records inside Claude or Codex — start from one of them, or call the endpoints below yourself.

Endpoints

9 ready-to-call endpoints

GET/threads/posts$min $0.003

Get a Threads post by URL

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.

Details →
GET/threads/resolve/media-id$min $0.001

Resolve a Threads post URL into its numeric 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.

Details →
GET/threads/search/profiles$min $0.003

Search Threads users by keyword

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.

Details →
GET/threads/search/recent$min $0.001

Search recent Threads posts

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.

Details →
GET/threads/search/top$min $0.001

Search top Threads posts

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.

Details →
GET/threads/users/{username}$min $0.003

Get a Threads user profile by 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.

Details →
GET/threads/users/{username}/posts$min $0.001

List Threads posts authored by a user

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.

Details →
GET/threads/users/{username}/replies$min $0.001

List Threads replies authored by a user

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.

Details →
GET/threads/users/{username}/reposts$min $0.001

List Threads reposts by a user

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.

Details →