# Threads Search Users API (https://www.socialcrawl.dev/platforms/threads/search-users)

> Searches Threads for user accounts matching a query. Returns matching profiles with follower counts and verification status.

TL;DR: `GET /v1/threads/search/users` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword or phrase to find Threads users |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/threads/search/users?query=tech" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I find Threads users by keyword?

Send a GET request to /v1/threads/search/users with a query parameter. SocialCrawl returns matching user profiles with follower counts, verification status, bio preview, and avatar URLs — ideal for creator discovery.

### What data does each user result include?

Each result comes with the user id, handle, display name, avatar URL, short bio, follower count, and verification status. Everything is normalised into the same author schema used across all SocialCrawl platforms.

### How is this different from searching posts?

This endpoint finds user accounts that match your keyword (handles, display names, bios); the search endpoint finds posts that match your keyword. Use this for influencer discovery; use search for content and mention tracking.

### Can I filter the results by verification or follower count?

The endpoint returns verification status and follower count on every result, so you can filter client-side to find verified creators or accounts above a specific follower threshold — perfect for building targeted outreach lists.

### How much does the Threads User Search API cost?

Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required — enough to run 100 user searches before paying anything, great for prototyping creator workflows.

See the full Threads API: https://www.socialcrawl.dev/platforms/threads

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to find Threads users by keyword with an API
- What does the SocialCrawl Threads search/users endpoint return?