Threads

Threads Post Search API

Threads keyword search — posts with engagement + media.

Pass a keyword and get public Threads posts from Meta's Top SERP hydrate as clean JSON: id, code, url, text, ISO publishedAt, author{username,displayName,verified}, engagement{views,likes,replies,reposts,quotes}, threadId/isReply/isQuote, and media[] (carousel children deduped — the same image never appears twice in different crops). orderBy=relevant (default) keeps Meta's query ranking; post_dated sorts that fetched window by publishedAt newest-first; engagement ranks by likes+replies+reposts+quotes+views. Unknown orderBy is 400. The sort is the returned page, not a second crawl of Threads. Flat 2 credits (parity with twitter/search). When Meta's search page itself renders 'No results' the answer is an immediate empty 200 at 0 credits — a definitive verdict, not an outage, so there is nothing to retry. A transient Meta miss is retried in-request, then rescued by the same query's 6h last-good page (labelled stale:true + cached:true, fetchedAt = scrape time, servedAt = now, 0 credits), then the fallback path. A retryable 502 UPSTREAM_UNAVAILABLE (0 credits) is returned only when every path missed — the endpoint never answers 404 “No posts found” for an upstream outage. Pass cache=true for the 24h shared cache (0 credits on hit).

Docs: https://captapi.com/apis/threads-search

get/v1/threads/search

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/threads/search
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

qstring required

Keyword or phrase to search public Threads posts (min 2 characters).

limitinteger

Max items to return (default 25, max 200). Flat 2 credits per call.

orderBystring

Sort the fetched page: relevant (default, Meta Top / similar to query), post_dated (newest publishedAt first), or engagement (likes+replies+reposts+quotes+views). Unknown values are 400.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.