APIs / Social media / Threads
1 credit per call8 endpoints
Threads API
Get Threads data as structured JSON with one API key: search, search users, oembed and post. Free credits every month.
Threads
GET/v1/threads/search?query=coffee
curl "https://api.perceptlayer.com/v1/threads/search?query=coffee" \
-H "X-API-Key: $API_KEY"cURL1 credit per successful call
Run this call below or from your dashboard to see a live response.
Playground
Run this API
curl "https://api.perceptlayer.com/v1/threads/search?query=coffee" \
-H "X-API-Key: $API_KEY"Threads · 8 endpoints
Endpoints
Every endpoint takes the same key. Open one for its parameters and an example request.
Note
Endpoints marked “Needs terms” return personal or social data. They work once you accept the restricted-endpoint terms in your dashboard.
| Endpoint | Required parameters | Cost |
|---|---|---|
GET/v1/threads/oembed | urlNeeds terms | 1 credit |
GET/v1/threads/post | usernamecodeNeeds terms | 1 credit |
GET/v1/threads/profile | usernameNeeds terms | 1 credit |
GET/v1/threads/search | queryNeeds terms | 1 credit |
GET/v1/threads/search-users | queryNeeds terms | 1 credit |
GET/v1/threads/tag | nameNeeds terms | 1 credit |
GET/v1/threads/user-posts | username+1 optionalNeeds terms | 1 credit |
GET/v1/threads/user-replies | username+1 optionalNeeds terms | 1 credit |
Overview
About the Threads API
What you can get
The Threads API returns search, search users, oembed and post as clean JSON. Each successful call costs one credit, and calls that fail are free.
Social mediaJSONRESTMCPSome endpoints need terms
More social media APIs
Use cases
Monitor mentions of your brand
Use the Threads API to monitor mentions of your brandFind and vet creators
Use the Threads API to find and vet creatorsTrack trends and engagement over time
Use the Threads API to track trends and engagement over timeFAQ
Questions
How much does the Threads API cost?
Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.
What format are responses in?
Every endpoint returns JSON, with no HTML parsing on your side.
Do I need a separate key for Threads?
No. One key works for every API in the catalogue.
Try the Threads API with 1,000 free credits
No credit card. Failed calls are never billed.