# Threads Account Search

Search public Threads accounts. The response carries exactly the fields the answering upstream query supplies, typically username, user id, full name, profile image and verification status, and for some responses also a biography and friendship status. Fields the upstream does not supply are omitted rather than filled in. No result count is documented because the upstream page size is not fixed. Follower counts are not part of this endpoint; use the profile endpoint for those.

- **Documentation:** [https://scrappa.co/docs/threads-api/threads_search_users](https://scrappa.co/docs/threads-api/threads_search_users)
- **API group:** Threads API
- **Endpoint:** `GET https://scrappa.co/api/threads/search-users`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Name, handle fragment, or keyword to match accounts by. |

## Example response

```json
{
    "meta": {
        "attempts": 1,
        "duration_ms": 700,
        "endpoint_family": "threads_search_users"
    },
    "users": [
        {
            "pk": "17841400000000000",
            "username": "nasa",
            "full_name": "NASA",
            "is_verified": true
        }
    ],
    "search_parameters": {
        "query": "nasa",
        "engine": "threads_search_users"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Returned, and not billed, when the handle, post code or hashtag does not exist or is not publicly available. |
| 422 | Validation Error | Returned, and not billed, when a parameter is missing or outside its allowed range. |
| 503 | Service Unavailable | A retryable, non-billable failure. The upstream returned a degraded or unreadable response, or the request budget ran out. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)