tiktokshop

Sales

Returns, per market, listings found, their units sold added up, an estimated sales figure in local currency, and the top listings by units for a keyword.

Use it to compare a keyword's unit sales across several markets in one call; use search directly when you only need one market's listings.

Metered: 0–80 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

get/v1/tiktokshop/sales

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/tiktokshop/sales
  • Auth: API key in header x-api-key

Query parameters

querystring required
Example:lip gloss

Product keyword, sent unchanged to each market's search (1-200 characters).

regionsstring
Example:US,GB,MY

Comma-separated markets, up to 8: US, GB, DE, FR, IT, ES, IE, ID, MY, MX, PH, SG, TH, VN, BR, JP. Default US.

topinteger

How many top listings by units to return per market, 1 to 20. Default 5.

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
dataConventionsData 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.