Threads scraper API
The Threads scraper API for public profiles, posts, replies and keyword search, as JSON. No Meta app and no account that has to authorize you.
6 endpoints · from 10 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/threads/profile?handle=example_creator" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Threads data can you get?
Public Threads data only, returned in the same JSON envelope as every other platform.
Posts and replies
An account's posts, one post in full including quote posts, and the replies under it.
What people build with the Threads API
Brand and product mentions
Search Threads for your brand between two dates and get every matching post with its author, text, language and engagement. Filter out posts that only share its name, and score sentiment, with your own keyword rules or model.
Creator discovery
Find accounts by name or topic with search/users, add include=profile for follower counts and bios on the same rows, then read a shortlist's recent posts.
Topic and conversation research
Every post carries the topic tag it was filed under, so a keyword search shows which communities are discussing it, and post/comments shows the replies underneath.
Threads API endpoints
All 6 Threads endpoints and their price in credits. 4 are metered: they show a range and charge what the call actually read.
| Endpoint | Credits | What it returns |
|---|---|---|
| /profile | 10 | Returns a Threads account's public profile: bio, the external link set in that bio, follower count, profile picture URL, and verification status. |
| /user/posts | 10–1,650 | Returns a Threads user's most recent posts, usually about 15. |
| /post | 10 | Returns one Threads post's text, like, reply and repost counts, every carousel slide or video URL, author, creation time, and topic tag at post.ext.topic_tag. |
| /search | 10–340 | Returns Threads posts matching a keyword, each with its text, like count, author, creation time, and the topic tag it was filed under at post.ext.topic_tag, plus a cursor for the next window. |
| /post/comments | 10–100 | Returns the replies Threads bundles with a post, usually about 20. |
| /search/users | 10–130 | Returns Threads accounts matching a query, with handle, display name, avatar and verification status. |
Parameters, response fields and examples for each endpoint are in the Threads API reference.
InsightSocial vs the official Threads API
Meta's Threads API is built for publishing and for reading accounts that authorize your app.
| InsightSocial API | Official Threads API | |
|---|---|---|
| Whose data | Any public account | Accounts that authorize your app |
| Approval | None. Sign in and copy a key | Meta app and app review |
| Replies | Under any public post | Mainly on your own posts |
| Cost per call | 10 credits | No per-call price; only accounts that authorize your app |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Threads API cost?
Threads calls start at 10 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 1,000 profiles at 10 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Retries are free
Resend a request with the same Idempotency-Key and the replay costs 0. Repeating a call without one is charged like the first time, because it can return newer data.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Threads data in plain English. Same account, same credits.
Threads API: frequently asked questions
Meta's Threads API is designed around accounts that authorize your app. The InsightSocial API reads any public profile, its posts and the replies under them with one key.
Yes. /v1/threads/search returns posts for a keyword and /v1/threads/search/users returns accounts.
A profile is 10 credits. Posts, replies and search are priced per endpoint and listed before you call. Calls that fail or find nothing are free.
Yes. /v1/threads/search takes a keyword with start_date and end_date and returns the matching public posts with author, text, language and engagement counts. The API returns the posts as Threads serves them; deciding which ones are really about your brand, and their sentiment, happens on your side with keyword rules or your own model.
/v1/threads/user/posts returns an account's most recent posts, usually about 15. Set limit up to 50 to read further back, or since= to stop at a date.
/v1/threads/post/comments returns the replies Threads bundles with a post, usually about 20, in one window with no cursor. Set limit above 25, up to 50, to collect more first-level replies.
No. There is no Threads app, OAuth flow or review. One API key in the x-api-key header works for Threads and the other 24 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. An answer served from the shared cache costs 2 credits. Repeating a call is charged like the first time, because it can return newer data.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Threads's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Threads API guides
The same key works for 24 more platforms
- Instagram scraper API
- TikTok scraper API
- Facebook scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API