---
title: "Search › Users"
method: GET
path: "/v1/tiktok/search/users"
tags: ["tiktok"]
---

# Search › Users

`GET /v1/tiktok/search/users`

## Request

- Base URL: `https://api.insightsocial.app`
- URL: `https://api.insightsocial.app/v1/tiktok/search/users`
- Auth: API key in header `x-api-key`

Returns TikTok accounts for a search term with username, name, avatar, followers, verification. include=profile adds bio, region, link and category.

Use it to find accounts by name or topic. Add country=KR (or US, DE, …) when you need creators in one country. The video searches, search and search/top, give you posts rather than accounts.

**Metered: 10–1310 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by `cursor`: see [Pagination](https://www.insightsocial.app/docs/pagination).

## Query parameters

- `query` string, required
- `cursor` integer
- `trim` boolean
- `include` 'profile'
- `limit` integer
- `country` 'US' | 'GB' | 'CA' | 'AU' | 'NZ' | 'IE' | 'DE' | 'FR' | 'ES' | 'IT' | 'PT' | 'NL' | 'BE' | 'CH' | 'AT' | 'SE' | 'NO' | 'DK' | 'FI' | 'IS' | 'PL' | 'CZ' | 'SK' | 'HU' | 'RO' | 'BG' | 'GR' | 'HR' | 'RS' | 'SI' | 'UA' | 'RU' | 'TR' | 'IL' | 'AE' | 'SA' | 'QA' | 'KW' | 'EG' | 'MA' | 'ZA' | 'NG' | 'KE' | 'GH' | 'TZ' | 'ET' | 'BR' | 'MX' | 'AR' | 'CO' | 'CL' | 'PE' | 'VE' | 'EC' | 'UY' | 'PY' | 'BO' | 'CR' | 'PA' | 'DO' | 'JM' | 'JP' | 'KR' | 'CN' | 'TW' | 'HK' | 'MO' | 'SG' | 'MY' | 'ID' | 'TH' | 'VN' | 'PH' | 'IN' | 'PK' | 'BD' | 'LK' | 'NP' | 'MM' | 'KH'
- `dry_run` '1'

## Response `200`

Success.

- object
  - `success` true, required
  - `platform` string, required
  - `endpoint` string, required
  - `schema_version` '2', required
  - `data` ProfilePage, required
    - `items` object[], required
      - `author` Profile, required
        - `id` string, required: An identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
        - `username` string, nullable, required
        - `display_name` string, nullable, required
        - `avatar_url` string, uri, nullable, required
        - `bio` string, nullable, required
        - `verified` boolean, nullable, required
        - `followers` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `followers_approximate` boolean, nullable, required
        - `following` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `posts_count` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `likes_count` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `url` string, uri, nullable, required
        - `location` string, nullable, required
        - `external_url` string, uri, nullable, required
        - `private` boolean, nullable, required
        - `joined_at` string, date-time, nullable, required: ISO-8601 timestamp in UTC, ending in Z.
        - `last_post_at` string, date-time, nullable, required: ISO-8601 timestamp in UTC, ending in Z.
        - `ext` object, nullable, required: Platform-specific fields, snake_case. The key list per platform is in the docs.
    - `total` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
    - `truncated` boolean, nullable, required
    - `ext` object, nullable: Platform-specific fields, snake_case. The key list per platform is in the docs.
  - `pagination` Pagination
    - `next_cursor` string, nullable, required
    - `has_more` boolean, required
    - `page_size` integer, required
    - `stopped_at` 'since' | 'known_id' | 'end', nullable
  - `unavailable` string[], required
  - `credits_used` integer, required
  - `credits_remaining` integer, required
  - `request_id` string, required
  - `cached` boolean, required
  - `idempotent_replay` boolean, required
  - `charge_reason` string, required
  - `free_call` boolean, required

## Other responses

- `400`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `401`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `402`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `404`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `409`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `429`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `500`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `503`: See [Error handling](https://www.insightsocial.app/docs/errors).

---

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