TikTok / Social Commerce

TikTok Ad Search

TikTok Ad Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.

post/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-search/run

Request

Base URL: https://api.nexscope.ai
URL: https://api.nexscope.ai/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-search/run
Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

country'br' | 'de' | 'es' | 'fr' | 'gb' | 'id' | 'it' | 'jp' | 'mx' | 'my' | 'ph' | 'sg' | 'th' | 'us' | 'vn' required

Lowercase request market. Returned country_code may differ; preserve both.

pageinteger

Page number, starting at 1. No automatic pagination.

pageSizeinteger

Items per page, from 1 to 10. Omission preserves the upstream default.

keywordstring

Ad search keyword.

categorystring

Provider-approved product category.

adTypestring

Provider-approved ad type value; no enum is published.

excludeSparkAdsboolean

Whether to exclude Spark Ads.

minViewsnumber