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

Code example

{
  "country": "us",
  "id": "7643101948819835678",
  "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

Livestream identity: id.

data.data.items[].title

string

optional

Livestream identity: title.

data.data.items[].room_link

string

optional

Livestream identity: room link.

data.data.items[].user_id

string

optional

Livestream identity: user id.

data.data.items[].user_nickname

string

optional

Livestream identity: user nickname.

data.data.items[].country_code

string

optional

Livestream identity: country code.

data.data.items[].most_product_category_label

string

optional

Livestream identity: most product category label.

data.data.items[].start_time

integer

optional

Unix timestamp in milliseconds: start time.

data.data.items[].end_time

integer

optional

Unix timestamp in milliseconds: end time.

data.data.items[].cover

object

optional

Image object with url and thumb_url: cover.

data.data.items[].user_avatar

object

optional

Host avatar with url and thumb_url: user avatar.

data.data.items[].user_follower_count

integer

optional

Host historical count: user follower count.

data.data.items[].user_live_count

integer

optional

Host historical count: user live count.

data.data.items[].user_avg_audience_count

number

optional

Host historical average audience: user avg audience count.

data.data.items[].user_avg_max_audience_count

number

optional

Host historical average audience: user avg max audience count.

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 livestream identifier: id.

data.data.core.items[].core_room_id

string

optional

Core livestream identifier: core room id.

data.data.core.items[].core_country_code

string

optional

Core livestream identifier: core country code.

data.data.core.items[].core_gmv

object

optional

Monetary metric with original unit and value: core gmv.

data.data.core.items[].core_gpm

object

optional

Monetary metric with original unit and value: core gpm.

data.data.core.items[].core_avg_price

object

optional

Monetary metric with original unit and value: core avg price.

data.data.core.items[].core_product_count

integer

optional

Core livestream performance count: core product count.

data.data.core.items[].core_sold_product_id_count

integer

optional

Core livestream performance count: core sold product id count.

data.data.core.items[].core_total_sold_count

integer

optional

Core livestream performance count: core total sold count.

data.data.core.items[].core_total_user

integer

optional

Core livestream performance count: core total user.

data.data.core.items[].core_max_user_count

integer

optional

Core livestream performance count: core max user count.

data.data.core.items[].core_new_follow_count

integer

optional

Core livestream performance count: core new follow count.

data.data.core.items[].core_avg_online_viewer

number

optional

Average online audience: core avg online viewer.

data.data.core.items[].core_follower_conversion_rate

number

optional

Decimal follower conversion ratio: core follower conversion rate.

Name

Type

Required

Description

data

null

required

Data value used by this API operation.

TikTok Live Detail

What this API does

TikTok Live 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