POSThttps://api.nexscope.ai/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-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-shop-detail/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

Name	Type	Required	Description
`country`	`string`	required	Lowercase TikTok market code. Example: us
`id`	`string`	required	Shop ID, preserved as a string. Example: 7495205878591949358
`include`

Code example

{
  "country": "us",
  "id": "7495205878591949358",
  "include": "core,channel"
}

Response example

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

{
  "data": {
    "data": {
      "items": [
        {
          "id": null,
          "seller_id": null,
          "shop_name": null
        }
      ],
      "core": {
        "items": [
          {
            "id": null,
            "core_seller_id": null,
            "core_region": null
          }
        ]
      },
      "channel": {
        "items": [
          {
            "id": null,
            "channel_seller_id": null,
            "channel_seller_sold_count_for_last_30_days": null
          }
        ]
      }
    }
  },
  "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`

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 | null

optional

Request id value used by this API operation.

data.data

object | null

optional

Data value used by this API operation.

data.data.items

array | null

optional

Provider business records for TikTok Shop Detail. Known row fields: id, seller_id, shop_name, region, shop_rating, shop_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.

data.data.items[]

object | null

required

Item in data data items.

data.data.items[].id

any

optional

Source-documented id; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].seller_id

any

optional

Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].shop_name

any

optional

Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].region

any

optional

Source-documented region; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].shop_main_category

any

optional

Source-documented shop_main_category; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].shop_rating

any

optional

Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].shop_total_gmv

any

optional

Source-documented shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].business_info

any

optional

Source-documented business_info; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].seller_avatar

any

optional

Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].create_time

any

optional

Source-documented create_time; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].last_update_time

any

optional

Source-documented last_update_time; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].creator_user_id

any

optional

Source-documented creator_user_id; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].creator_user_name

any

optional

Source-documented creator_user_name; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].creator_nickname

any

optional

Source-documented creator_nickname; may be absent or null. Preserve the provider value and original monetary units.

data.data.items[].creator_role

any

optional

Source-documented creator_role; may be absent or null. Preserve the provider value and original monetary units.

data.data.total_count

integer | null

optional

Total matching records.

data.data.core

object | null

optional

Core value used by this API operation.

data.data.core.items

array | null

optional

Optional core detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.

data.data.core.items[]

object | null

required

Item in data data core items.

data.data.core.items[].id

any

optional

Source-documented id; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_id

any

optional

Source-documented core_seller_id; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_region

any

optional

Source-documented core_region; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_shop_product_count

any

optional

Source-documented core_seller_shop_product_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_shop_total_product_count

any

optional

Source-documented core_seller_shop_total_product_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_shop_total_sold_count

any

optional

Source-documented core_shop_total_sold_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_shop_total_gmv

any

optional

Source-documented core_seller_shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_sold_count_for_last_30_days

any

optional

Source-documented core_seller_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_gmv_for_last_30_days

any

optional

Source-documented core_seller_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_total_related_creator_count

any

optional

Source-documented core_seller_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_total_related_live_creator_count

any

optional

Source-documented core_seller_total_related_live_creator_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_total_related_video_creator_count

any

optional

Source-documented core_seller_total_related_video_creator_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.items[].core_seller_total_related_shop_creator_count

any

optional

Source-documented core_seller_total_related_shop_creator_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.core.total_count

integer | null

optional

Total count value used by this API operation.

data.data.channel

object | null

optional

Channel value used by this API operation.

data.data.channel.items

array | null

optional

Optional channel detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.

data.data.channel.items[]

object | null

required

Item in data data channel items.

data.data.channel.items[].id

any

optional

Source-documented id; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_seller_id

any

optional

Source-documented channel_seller_id; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_seller_sold_count_for_last_30_days

any

optional

Source-documented channel_seller_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_seller_gmv_for_last_30_days

any

optional

Source-documented channel_seller_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_video_30d_sold_count

any

optional

Source-documented channel_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_video_30d_gmv

any

optional

Source-documented channel_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_live_30d_sold_count

any

optional

Source-documented channel_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_live_30d_gmv

any

optional

Source-documented channel_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_product_card_30d_sold_count

any

optional

Source-documented channel_product_card_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_product_card_30d_gmv

any

optional

Source-documented channel_product_card_30d_gmv; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_personal_creator_30d_sold_count

any

optional

Source-documented channel_personal_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_personal_creator_30d_gmv

any

optional

Source-documented channel_personal_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_seller_creator_30d_sold_count

any

optional

Source-documented channel_seller_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.items[].channel_seller_creator_30d_gmv

any

optional

Source-documented channel_seller_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units.

data.data.channel.total_count

integer | null

optional

Total count value used by this API operation.

Name

Type

Required

Description

data

null

required

Data value used by this API operation.

Slug	`chuhaijiang-tiktok-shop-detail`
Headers	`Authorization: Bearer nk-...` `Content-Type: application/json`
Request body	API-specific JSON object.
Response body	Platform envelope: code, msg, data, ts, time, cost, traceId. Inspect data.status for asynchronous completion.

TikTok Shop Detail API

TikTok Shop Detail API

API overview

Authentication

Run an API

Status codes

Example request

Run this API

Endpoint

Request parameters

Code example

Response example

Response fields

Responses

Data source, freshness, and limitations

MCP

Call a tool

Online test

Try it

Related APIs

Any of option 1

Any of option 2