Headers
Get your API keyAPI key (`sfk_...`)
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.
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 (ISO-8601) when available.
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/threads/search?query=basketball" \
-H "x-api-key: YOUR_API_KEY"Responses
Search results for the requested query.