Skip to main content
POST
Threads Search API

Threads Search

Search Threads the way the app does and get the top posts for a keyword or hashtag. Every post comes with its text, author, likes, replies, reposts, media and publish time. It is the fastest way to see how a topic, product or event is being discussed on Threads, and to find the accounts driving that conversation.
Provide a keyword or hashtag in query. Each search returns the top posts Threads shows for it, about 20. Each post returned costs 0.6 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a keyword or hashtag in query. Each search returns the top posts Threads shows for it, about 20.

query
string
required

Search query.

Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object