Search Threads posts
Returns public Threads posts matching a search query. Optional date filters limit the search window.
Operation
/v1/threads/searchHeaders
API key (`sfk_...`)
Parameters
Search query text for public Threads posts.
min 1 chars · max 512 chars
Optional start date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Optional end date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Whether to request a smaller response shape when available.
Response fields
Endpoint-specific response payload.
Search query string evaluated for this response.
Threads posts matching the query.
Stable post identifier string.
min 1 chars
Social platform for this search result.
one of: threads
Canonical public post URL when available.
min 1 chars
Short post code used in public URLs when available.
min 1 chars
Post body text when available (may be empty).
Creation time as a Unix timestamp in seconds when available.
≥ 0
Author details when available.
Author profile identifier when available.
Author username without a leading @ when available.
Author display name when available.
Profile image URL for the author when available.
Whether the author is marked as verified.
Whether the author account is private when known.
Canonical public profile URL when available.
Engagement metrics for this post.
Like count when available.
≥ 0
Repost count when available.
≥ 0
Quote-post count when available.
≥ 0
Direct reply count when available.
≥ 0
Image and video items extracted from the post.
Normalized media type for this item.
one of: image, video, unknown
Direct URL for this media item when available.
min 1 chars
Width in pixels when available.
≥ 0
Height in pixels when available.
≥ 0
Count of posts returned in this response.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Search results for the requested query.
Error codes
Profile posts
Returns recent public posts for a Threads handle. For handle resolution, inspect `data.lookupStatus` (`found` vs `not_found`). An empty `data.posts` array can still accompany `lookupStatus: "found"` when the handle resolves but no posts are returned. Call `GET /v1/threads/profiles/{handle}` first if you need `private` vs `not_found` for the account itself.
Post
Returns public metadata for a single Threads post. Whether the post was found is indicated in `data.lookupStatus`.