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

> Searches X (Twitter) for user accounts matching a name, handle, or keyword. Each match includes the username, display name, bio, avatar, follower and following counts, tweet count, location, verification status, join date, and whether the account is private. Matching covers handle and display-name tokens with no spelling correction, so a misspelled handle surfaces lookalike and parody accounts rather than the real one; verify the returned handle before relying on it. Page size is set by the source, typically around 20 accounts. To go deeper, send `pagination.next_cursor` back as `cursor` and repeat until `pagination.has_more` is false; each page costs 1 credit.

TL;DR: `GET /v1/twitter/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 | Name, handle, or keyword to search accounts for |
| `cursor` | no | Cursor from the previous response's pagination.next_cursor to fetch the next page |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/twitter/search/users" \
  --data-urlencode "query=news24" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full X API: https://www.socialcrawl.dev/platforms/twitter

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