Threads API for public profiles, posts and search
Captapi's Threads API reads public Threads data and returns JSON: a profile, an account's recent posts, one post with its counts and the first page of its public replies, and keyword search for posts or profiles. One API key, read-only. It is separate from Meta's official Threads API, which works through a Meta app and user access tokens.
curl "https://api.captapi.com/v1/threads/profile?url=https%3A%2F%2Fsummer-heart-0930.chufeiyun1688.workers.dev%3A443%2Fhttps%2Fwww.threads.net%2F%40nasa" \
-H "Authorization: Bearer capt_live_..."What is the Threads API?
Public Threads profiles, recent posts, and keyword search as JSON — no Meta app or Facebook Login. Every endpoint is a single authenticated GET request that responds with predictable JSON, so the data drops straight into dashboards, AI pipelines, RAG systems, and no-code automations. AI agents can call the same endpoints as MCP tools via @captapi/mcp.
Compared with Threads API: Use Captapi instead of Meta's Threads API when you need public profile, post, or keyword-search JSON and you do not want to stand up a Meta app. Keep Meta's API when you must publish on a Threads account you own or read insights for that account. Threads API alternative.
Meta's official Threads API vs. this API
Meta's Threads API and the Captapi Threads endpoints are separate products. The official column is quoted from Meta's Threads documentation.
| Meta's Threads API | Captapi Threads API | |
|---|---|---|
| What it does | “Use the Threads API to create and publish posts, retrieve media and profiles, moderate replies, and access insights.” | Read-only public data: profiles, recent posts, one post with the first page of its public replies, keyword search for posts and profiles. |
| Access | Access token and permissions; threads_basic is “Required for making any calls to all Threads API endpoints.” | One Captapi API key as a Bearer header. No Meta app. |
| Keyword search | Needs threads_keyword_search. Until it is approved, “the search is performed only on posts owned by the authenticated user.” “A user can send a maximum of 2,200 queries within a rolling 24-hour period.” | /v1/threads/search for public posts and /v1/threads/search-users for profiles, billed per call. |
| Publishing | Yes. “Threads profiles are limited to 250 API-published posts within a rolling 24-hour period.” | No. Captapi does not post. |
Sources: Meta Threads API documentation (read 2026-11-17) · Meta Threads API, Keyword Search (read 2026-11-17) · Meta Threads API, Overview (read 2026-11-17)
Working example: search public Threads posts
Keyword search across public Threads posts. The response was captured live from this endpoint and trimmed to two posts and the fields below.
Search posts (2 credits)
curl "https://api.captapi.com/v1/threads/search?q=artificial%20intelligence&orderBy=relevant" \
-H "Authorization: Bearer capt_live_..."orderBy is relevant (default), post_dated or engagement. If the search page itself shows no results, the call is an empty 200 at 0 credits.
An account's recent posts (2 credits)
curl "https://api.captapi.com/v1/threads/user-posts?url=https%3A%2F%2Fsummer-heart-0930.chufeiyun1688.workers.dev%3A443%2Fhttps%2Fwww.threads.net%2F%40nytimes" \
-H "Authorization: Bearer capt_live_..."Returns the short window of recent posts Threads shows publicly, with text, publishedAt, reply and quote flags, like/reply/repost/quote counts and media.
Endpoints
What you can do with the Threads API
Profile
GET /v1/threads/profile
Threads profile — displayName, isPrivate, bioLinks (Meta verified), isThreadsOnlyUser, transparencyLabel, bioFragments, HD avatars (1 credit).
1 credit
User Posts
GET /v1/threads/user-posts
Recent public Threads posts — text, publishedAt, like/reply/repost/quote counts, threadId/isReply, media[]. Flat 2 credits.
2 credits
Post Details
GET /v1/threads/post-details
One Threads post — text, author, like/reply/repost/quote counts, first page of public replies as comments[], media[]. Flat 1 credit.
1 credit
Post Search
GET /v1/threads/search
Threads keyword search — posts with like/reply/repost/quote counts + media. orderBy relevant | post_dated | engagement. Flat 2 credits.
2 credits
Search Users
GET /v1/threads/search-users
Threads user discovery from keyword search — id, handle, avatar, verified. Flat 1 credit.
1 credit
How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Call any endpoint above with
Authorization: Bearer capt_live_...and parse the JSON response. Passcache=trueto reuse a prior response from the 24h cache at no cost.
What you can't get
Credits: Profile, Post Details and Search Users cost 1 credit; User Posts and Search cost 2. cache=true serves a 24h cached response at no charge.
- Posting, replying or insights. The API is read-only.
- All replies to a post. Post Details returns the first page of public replies (comments[], typically about 10), with no cursor for more.
- Following and post counts on a profile. Threads does not show them on the public profile, so the keys are omitted rather than set to zero.
- An account's full history. User Posts returns the recent window Threads shows publicly; a larger limit does not extend it.
Threads API guides
Frequently asked questions
Is this Meta's official Threads API?+
No. Captapi is an independent REST API that returns public Threads data as JSON. Meta's Threads API is a separate product that works with an access token and permissions such as threads_basic (Meta Threads API docs, read 2026-11-17).
Do I need a Meta developer app or access token?+
No. You only need a Captapi API key, sent as a Bearer header.
Can I search Threads by keyword?+
Yes. /v1/threads/search searches public posts and /v1/threads/search-users finds public profiles. On Meta's API, keyword search needs the threads_keyword_search permission, and a user can send up to 2,200 queries in a rolling 24-hour period (Meta Keyword Search docs, read 2026-11-17).
Can I publish posts or reply?+
No. Captapi only reads public data. Publishing needs Meta's Threads API.
Can I get the replies or view counts of a post?+
Replies: Post Details returns the first page of public replies from other accounts as comments[] (typically about 10, including replies to those replies), each with id, text, author, publishedAt, likes and replyToId. Threads shows further pages only to signed-in viewers, so there is no cursor, and comments[] is left out when no other account has replied. Views: Threads rarely exposes view counts. When it does, they appear in the post's engagement; otherwise they're absent.
Why is the following count missing?+
Threads does not show following or post counts on the public profile, so Captapi omits those keys.
How much does a call cost?+
Profile, Post Details and Search Users cost 1 credit. User Posts and Search cost 2 credits. New accounts start with 100 free credits.
Explore other platforms
Start using the Threads API in sixty seconds
Sign up, grab your API key, and make your first request. 100 credits on the house — no credit card.