---
title: "Threads Search Users API"
method: GET
path: "/v1/threads/search-users"
tags: ["Threads"]
---

# Threads Search Users API

`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`

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

## Query parameters

- `q` string, required
- `limit` integer
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `query` string: The search query you sent.
    - `totalReturned` integer: Number of items returned in this response.
    - `users` object[]
      - `id` string: Id of this users item.
      - `username` string: Account username / handle.
      - `displayName` string: Display name of the account. Canonical across profile endpoints (prefer over name).
      - `url` string: Canonical URL of the item.
      - `verified` boolean: true/false when Meta embeds the badge flag; null when omitted (unknown).
      - `profileImage` string: Avatar URL when Meta embeds it on the search-post author card.
      - `followers` unknown

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)