POSThttps://api.nexscope.ai/api/skill-api/v1/skills/chuhaijiang-tiktok-creative-search/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/api/skill-api/v1/skills/chuhaijiang-tiktok-creative-search/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

Name	Type	Required	Description
`country`	`string`	required	Lowercase request market. Returned country_code may differ; preserve both. Example: us
`page`	`integer`	optional	Page number, starting at 1. No automatic pagination. Example: 1
`pageSize`	`integer`	optional	Items per page, from 1 to 10. Omission preserves the upstream default. Example: 3
`keyword`	`string`	optional	Creative search keyword. Example: beauty
`category`

Code example

{
  "country": "us",
  "page": 1,
  "pageSize": 3
}

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "data": {
    "data": {
      "items": [],
      "total_count": 0
    }
  },
  "code": 0,
  "msg": "ok",
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Response fields

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`

Responses

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Name

Type

Required

Description

data

object

required

Data value used by this API operation.

data.request_id

string

optional

Request id value used by this API operation.

data.data

object

optional

Data value used by this API operation.

data.data.items

array

optional

Items value used by this API operation.

data.data.items[]

object

required

Item in data data items.

data.data.items[].id

string

optional

Creative identity and copy: id.

data.data.items[].video_id

string

optional

Creative identity and copy: video id.

data.data.items[].product_id

string

optional

Creative identity and copy: product id.

data.data.items[].author_uid

string

optional

Creative identity and copy: author uid.

data.data.items[].author_unique_id

string

optional

Creative identity and copy: author unique id.

data.data.items[].author_nickname

string

optional

Creative identity and copy: author nickname.

data.data.items[].video_desc

string

optional

Creative identity and copy: video desc.

data.data.items[].country_code

string

optional

Creative identity and copy: country code.

data.data.items[].platform

string

optional

Creative identity and copy: platform.

data.data.items[].follower_cnt

integer

optional

Creative audience and engagement count: follower cnt.

data.data.items[].video_play_count

integer

optional

Creative audience and engagement count: video play count.

data.data.items[].video_like_count

integer

optional

Creative audience and engagement count: video like count.

data.data.items[].video_comment_count

integer

optional

Creative audience and engagement count: video comment count.

data.data.items[].video_share_count

integer

optional

Creative audience and engagement count: video share count.

data.data.items[].video_collect_count

integer

optional

Creative audience and engagement count: video collect count.

data.data.items[].video_engagement_rate

number

optional

Provider engagement ratio: video engagement rate.

data.data.items[].video_30d_gmv

object

optional

Monetary metric with original unit and value: video 30d gmv.

data.data.items[].video_total_gmv

object

optional

Monetary metric with original unit and value: video total gmv.

data.data.items[].video_30d_gpm

object

optional

Monetary metric with original unit and value: video 30d gpm.

data.data.items[].is_aigc_video

any

optional

Provider is aigc video. The source establishes this field name; preserve its runtime JSON type and missing values.

data.data.items[].content_tag_v2

any

optional

Provider content tag v2. The source establishes this field name; preserve its runtime JSON type and missing values.

data.data.items[].video_launch_time

any

optional

Provider video launch time. The source establishes this field name; preserve its runtime JSON type and missing values.

data.data.items[].video_date

any

optional

Provider video date. The source establishes this field name; preserve its runtime JSON type and missing values.

data.data.items[].video_duration

any

optional

Provider video duration. The source establishes this field name; preserve its runtime JSON type and missing values.

data.data.items[].content_intent

any

optional

Provider content intent. The source establishes this field name; preserve its runtime JSON type and missing values.

data.data.items[].user_avatar

any

optional

Provider user avatar. The source establishes this field name; preserve its runtime JSON type and missing values.

data.data.total_count

integer

optional

Total count value used by this API operation.

Name

Type

Required

Description

data

null

required

Data value used by this API operation.

TikTok Creative Search

What this API does

TikTok Creative Search

What this API does

Authentication

Run an API

Example request

Check the response

HTTP status codes

Run this API

Endpoint

Request parameters

Code example

Response example

Response fields

Responses

Data source, freshness, and limitations

MCP

Call a tool

Legacy MCP v1

Online test

Try it

Related APIs

Any of option 1

Any of option 2