POSThttps://api.nexscope.ai/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-detail/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-ad-detail/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
`id`	`string`	required	Ad ID returned by its search operation. Keep identifiers as strings to avoid precision loss. Example: 7658119807128046879
`include`	`string`	optional	Comma-separated expansions: core. Request only needed expansions. Example: core

Code example

{
  "country": "us",
  "id": "7658119807128046879",
  "include": "core"
}

Response example

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

{
  "data": {
    "data": {
      "items": []
    }
  },
  "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

Ad identity and copy: id.

data.data.items[].ad_title

string

optional

Ad identity and copy: ad title.

data.data.items[].advertiser_id

string

optional

Ad identity and copy: advertiser id.

data.data.items[].advertiser_name

string

optional

Ad identity and copy: advertiser name.

data.data.items[].ad_url

string

optional

Ad identity and copy: ad url.

data.data.items[].web_url

string

optional

Ad identity and copy: web url.

data.data.items[].button_text

string

optional

Ad identity and copy: button text.

data.data.items[].advertiser_avatar

object

optional

Provider image object: advertiser avatar.

data.data.items[].ad_cover

object

optional

Provider image object: ad cover.

data.data.items[].duration

integer

optional

Provider time or duration; preserve original units: duration.

data.data.items[].ad_create_time

integer

optional

Provider time or duration; preserve original units: ad create time.

data.data.items[].create_time

integer

optional

Provider time or duration; preserve original units: create time.

data.data.items[].last_update_time

integer

optional

Provider time or duration; preserve original units: last update time.

data.data.core

object

optional

Core value used by this API operation.

data.data.core.items

array

optional

Items value used by this API operation.

data.data.core.items[]

object

required

Item in data data core items.

data.data.core.items[].id

string

optional

Core ad identity or provider ad type: id.

data.data.core.items[].core_creative_id

string

optional

Core ad identity or provider ad type: core creative id.

data.data.core.items[].core_ad_type

string

optional

Core ad identity or provider ad type: core ad type.

data.data.core.items[].core_ad_day_count

integer

optional

Core ad performance count: core ad day count.

data.data.core.items[].core_total_sc

integer

optional

Core ad performance count: core total sc.

data.data.core.items[].core_video_play_count

integer

optional

Core ad performance count: core video play count.

data.data.core.items[].core_video_like_count

integer

optional

Core ad performance count: core video like count.

data.data.core.items[].core_video_comment_count

integer

optional

Core ad performance count: core video comment count.

data.data.core.items[].core_video_share_count

integer

optional

Core ad performance count: core video share count.

data.data.core.items[].core_video_collect_count

integer

optional

Core ad performance count: core video collect count.

data.data.core.items[].core_ad_play_ratio

number

optional

Provider ratio or score; preserve original metric definition: core ad play ratio.

data.data.core.items[].core_ad_gmv_ratio

number

optional

Provider ratio or score; preserve original metric definition: core ad gmv ratio.

data.data.core.items[].core_ad_roas

number

optional

Provider ratio or score; preserve original metric definition: core ad roas.

data.data.core.items[].core_video_popularity

number

optional

Provider ratio or score; preserve original metric definition: core video popularity.

data.data.core.items[].core_ad_maximum_cost

object

optional

Provider monetary metric; preserve original unit and value: core ad maximum cost.

data.data.core.items[].core_total_gmv

object

optional

Provider monetary metric; preserve original unit and value: core total gmv.

data.data.core.items[].core_video_gpm_30d

object

optional

Provider monetary metric; preserve original unit and value: core video gpm 30d.

Name

Type

Required

Description

data

null

required

Data value used by this API operation.

TikTok Ad Detail

What this API does

TikTok Ad Detail

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