APIs / Social media / Threads

Threads API

Get Threads data as structured JSON with one API key: search, search users, oembed and post. Free credits every month.

8endpoints
1credit per successful call
JSONevery response
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 from your dashboard to see a live response.

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.
EndpointWhat it returnsCost
GET/v1/threads/oembedOembed Needs terms1 credit
GET/v1/threads/postPost Needs terms1 credit
GET/v1/threads/profileProfile Needs terms1 credit
GET/v1/threads/searchSearch Needs terms1 credit
GET/v1/threads/search-usersSearch Users Needs terms1 credit
GET/v1/threads/tagTag Needs terms1 credit
GET/v1/threads/user-postsUser Posts Needs terms1 credit
GET/v1/threads/user-repliesUser Replies Needs terms1 credit

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.

Use cases

  • Monitor mentions of your brand
  • Find and vet creators
  • Track trends and engagement over time

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 card and no password. We email you a sign-in link, and your key works on every API.

No credit card. 1,000 free credits a month.