Search public Threads posts by keyword or hashtag, optionally within a date range; up to 10 posts per call with engagement counts.
2 credits/ call
Never more than 26 credits a call.
You only pay when data comes back.
curl -X POST "https://api.primaryapi.com/v1/run/threads.search" \
-H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","startDate":"2026-10-01","endDate":"2026-10-30"}'{
"output": {
"found": true,
"data": {
"nextCursor": "<string | null>",
"posts": [
{
"username": "<string | null>",
"fullName": "<string | null>",
"likeCount": "<integer | null>",
"isVerified": "<boolean | null>", …
}
]
}
},
"credits": 2
}Input and output
3 fields
AI agents.2026-10-01.2026-10-30.14 fields
Good to know
Move endDate back to page through older posts.
Search can surface posts by private individuals. Callers need a lawful basis.
More from Threads. Same key, same credits.
The same key and credits work for every API.