tiktok

Search › Users

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.

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

Query parameters

querystring required
Example:cooking

Search keyword or phrase to find TikTok users

cursorinteger

Cursor to get more users. Get 'cursor' from previous response.

trimboolean

Accepted for compatibility; the response is already the canonical shape, so this flag has no effect.

include'profile'

Set to profile (one token only) to fill author.bio, author.location (the ISO region), external_url and author.ext.business_category on every row in this one call.

limitinteger

Take the top N rows of the page (1 to 30) after the search has run. On the global page it is not a page size: next_cursor still advances past the full page, so rows beyond N on this page are not returned by the next page.

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'
Example:KR

ISO 3166-1 alpha-2 account region to filter by (KR, US, DE, …). Omit it for the global default page. A code this endpoint does not accept is a free 400.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.