Threads

Threads Search Users API

Threads user discovery from keyword search — id, handle, avatar, verified.

Pass a keyword and get distinct Threads authors who appear in Meta's keyword post search as clean JSON: id (pk when embedded), username, displayName, url, verified, profileImage, and followers (usually null on this surface — call Threads Profile for counts). Flat 1 credit (parity with TikTok search-users). This is not a semantic people-search: users are unique authors of posts that matched the keyword on Top SERP, so handles may not contain the query. Pass cache=true for the 24h shared cache (0 credits on hit).

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

get/v1/threads/search-users

Request

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

Query parameters

qstring required

Keyword to find Threads users / creators (min 2 characters).

limitinteger

Max items to return (default 20, max 100). Flat 1 credit per call.

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.