# TikTok / Search

Search public TikTok users by query. Returns matching profiles only (not videos or other content).

```
GET /api/v1/tiktok/search
```

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
Credits: 1 credit per request

## Parameters

| Name | Required | Description | Example |
|------|----------|-------------|---------|
| `query` | yes | Search text. | `daviddobrik` |
| `cursor` | no | Pagination cursor from a previous response. |  |

## Example

```bash
curl -s 'https://trysocify.com/api/v1/tiktok/search?query=daviddobrik' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `users` | array | Matching users. |
| `users[].id` | string | User id. |
| `users[].username` | string | Username. |
| `users[].name` | string | Display name. |
| `users[].avatar` | string | Avatar URL. |
| `users[].followers` | number | Follower count, when present. |
| `users[].verified` | boolean | Whether verified. |
| `cursor` | string | Pass as cursor for the next page. |
## Sample response

Successful lookups wrap the payload in `{ ok, platform, resource, params, data, meta }`. `data` is shown below.

```json
{
  "ok": true,
  "platform": "tiktok",
  "resource": "search",
  "params": {
    "query": "daviddobrik"
  },
  "data": {
    "cursor": "10",
    "users": [
      {
        "avatar": "https://p16-sign-va.tiktokcdn.com/example.webp",
        "followers": 26357770,
        "id": "7119601",
        "name": "DAVID DOBRIK",
        "username": "daviddobrik",
        "verified": true
      }
    ]
  },
  "meta": {
    "credits_charged": 1,
    "latency_ms": 420,
    "platform": "tiktok",
    "resource": "search",
    "path": "/api/v1/tiktok/search"
  }
}
```

## Links

- HTML docs: https://trysocify.com/docs/api/tiktok/search
- SEO page: https://trysocify.com/tiktok/search
- OpenAPI: https://trysocify.com/openapi.json
- Catalog: https://trysocify.com/catalog.json