Nexscope

API de análisis de productos de TikTok

Analiza clasificaciones de productos de TikTok Shop y datos de precio, ventas, ingresos, comisiones, estado del anuncio y tienda por producto. Invoca la API mediante REST o MCP.

CosteRecent Avg. 22 · Range 11–22 credits / call
Probar en línea
POST · https://api.nexscope.ai/kd/product/rankMCP · nexscope_tiktok_product_analytics

Qué hace esta API

Analizar TikTok Shop tablas de clasificación de productos y precio de nivel de producto, ventas, ingresos, comisiones, estado de listado y datos de compras.

Casos de uso de API de análisis de productos de TikTok

Inspeccione un producto candidato

Para inspeccionar un producto candidato, un analista de mercado presenta la región y dateRange a TikTok Product Analytics. El código de error devuelto, errmsg, product_id ayudar a inspeccionar los atributos documentados del producto candidato.

Comparar detalles de la lista

Un analista de mercado utiliza el análisis de productos TikTok con la región y dateRange Para comparar los detalles de la lista. El errcode devuelto, errmsg, product_id ayudar a comparar los detalles del producto con otra lista preseleccionada.

Preparar pruebas de producto para una revisión de abastecimiento

Para este flujo de trabajo, un analista de mercado llama a TikTok Product Analytics con la región y dateRange El resultado ayuda a registrar los hechos del producto antes de una discusión sobre el abastecimiento.

Preguntas frecuentes sobre API de análisis de productos de TikTok

¿Qué hace el análisis de productos TikTok? API ¿Volver?

Analizar TikTok Shop tablas de clasificación de productos y precio, ventas, ingresos, comisiones, estado de la lista y datos de la tienda. La salida documentada incluye `errcode`, `errmsg`, `product_id`, `product_name`, `unit_price`, `sales_volumn`, `revenue`, `video_revenue`. Corresponde a los parámetros proporcionados `region`, `dateRange`, `currency`, `language`, `category_ids`. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene el análisis de productos TikTok? API ¿costo?

El coste documentado actualmente es Recent Avg. 22 · Range 11–22 credits / call. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo al análisis de productos TikTok? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /kd/product/rank con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_tiktok_product_analytics. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditosConecta esta API con MCP

Prueba esta API
Endpoint
https://api.nexscope.ai/kd/product/rank
Método MCP
nexscope_tiktok_product_analytics

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/kd/product/rank

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/kd/product/rank' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "currency": "USD",
  "dateRange": "last7Day",
  "pageNumber": 1,
  "pageSize": 20,
  "region": "US"
}'

Ejemplo de código

{
  "currency": "USD",
  "dateRange": "last7Day",
  "pageNumber": 1,
  "pageSize": 20,
  "region": "US"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

CódigoDescripción
200Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.
Todas las categorías/ Inteligencia de TikTok KD
POSThttps://api.nexscope.ai/kd/product/rank

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/kd/product/rank
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
category_idsarrayopcional
Category ID list filter
category_ids[]stringobligatorio
Filtro de lista de identificación de categoría
commission_ratenumberopcional
Affiliate product commission rate, such as `0.15`
creator_idstringopcional
Expert ID filtering
currencystringopcional
Currency unit, such as `USD`
dateRangestringopcional
Time range, such as `last7Day`, `last30Day`
is_affiliatestringopcional
Whether it is an alliance product: `PUBLIC_PLAN` (yes) or `NON_AFFILIATE` (no)
is_tts_productintegeropcional
Whether the product is fully managed: `1` (fully managed) or `0` (not fully managed)
languagestringopcional
Return language, for example `zh-CN`, `en-US`
livestream_idstringopcional
Returns the products associated with the specified live broadcast
pageNumberintegeropcional
Page number, range 1-5
pageSizeintegeropcional
Number of items per page, range 5-100
productIdstringobligatorio
TikTok product ID, such as `1729508370969629931`; the string can avoid the loss of large integer precision and can be obtained from the `product_id` of the list response
regionstringopcional
Region/market code, such as `US`
revenue_rangestringopcional
Transaction amount / GMV range, left closed and right open
shop_idstringopcional
Store ID filter
sortFieldobjectopcional
Sorting specification object, the available fields are subject to those actually accepted by the gateway.
unit_price_rangestringopcional
Product price range, left closed and right open
video_idstringopcional
Returns the products associated with the specified video

Respuesta de ejemplo

Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.

No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.

Campos de respuesta

Referencia de campos de respuesta (37 campos)

NombreTipoObligatorioDescripción
errcodeintegeropcional
Business status code, `200` indicates success
dataarrayopcional
List or detailed data; real response does not return `total`
costTokenintegeropcional
The deduction token for this call is usually `14000`
errmsgstringopcional
Status message, `ok` on success
product_idstringopcional
Product ID (string format to avoid loss of large integer precision), can be used as `productId` to query details
product_namestringopcional
Título del producto
unit_pricenumberopcional
Unit price, currency depends on `region`, such as US is USD
sales_volumnintegeropcional
Sales volume (units); field name `sales_volumn`, not `volume`
revenuenumberopcional
Total sales / GMV, equals `video_revenue` + `live_revenue` + `showcase_revenue`
video_revenuenumberopcional
Video channel sales
live_revenuenumberopcional
Live broadcast channel sales
showcase_revenuenumberopcional
Window/display channel sales
revenue_growth_ratenumberopcional
Sales growth rate (percentage, e.g. `27.94` represents 27.94%)
commission_ratenumberopcional
Commission rate, direct percentage, such as `25.0` means 25%, not basis points
launch_datestringopcional
Date on shelves (`YYYY-MM-DD`)
product_idstringopcional
Unique product ID (string, to avoid loss of large integer precision)
product_namestringopcional
Product name
product_regionstringopcional
The region/market where the product is located, such as `us`
product_shop_idstringopcional
Store ID
pri_cate_idstringopcional
First level category ID
sec_cate_idstringopcional
Secondary category ID
ter_cate_idstringopcional
Third-level category ID
unit_pricenumberopcional
Unit price in requested `currency` currency
min_pricenumberopcional
Lowest price in requested `currency` currency
max_pricenumberopcional
Highest price in requested `currency` currency
revenuenumberopcional
Total sales/GMV by requested `currency` currency
sales_volumnintegeropcional
Sales volume, field spelled `volumn`
commission_ratenumberopcional
Commission rate, direct percentage, `25.0` means 25%
product_review_countintegeropcional
Number of product reviews
launch_datestringopcional
Date on shelves (`YYYY-MM-DD`)
delivery_typestringopcional
Shipping method, such as `local`
video_numberintegeropcional
Number of associated videos
video_revenuenumberopcional
Sales generated by video in requested `currency` currency
live_numberintegeropcional
Number of associated live broadcasts
live_revenuenumberopcional
Sales generated by live streaming, in requested `currency` currency
shopping_mall_revenuenumberopcional
Marketplace sales in requested `currency` currency
creator_numberintegeropcional
Number of connected people

Respuestas

CódigoDescripción
200Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Fuente de datos, vigencia y limitaciones

La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy
POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_product_analytics",
    "arguments": {
      "dateRange": "last30Day",
      "pageNumber": 1,
      "pageSize": 10,
      "productId": "1732505564636812173",
      "region": "US",
      "sortField": {}
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What can TikTok Product Analytics reveal about Shop products, and how might I use it?

AI answer

Query TikTok Shop product rankings with market, period, and commerce filters, or look up a product using productId. The documented list and detail fields cover sales, channel mix, pricing, commission, and associated content; real responses do not include a total result count.

Data categoryDocumented fieldsWhat the values mean
Product and shopproduct_id, product_name, product_region, product_shop_id, pri_cate_id, sec_cate_id, ter_cate_idIdentifies the product, its market and shop, and category levels when supplied.
Price and listingunit_price, min_price, max_price, launch_date, delivery_typeReported price and range, date on shelves, and shipping method.
Salessales_volumn, revenue, revenue_growth_rateUnits sold, GMV, and percentage sales growth. The field is spelled sales_volumn.
Channel salesvideo_revenue, live_revenue, showcase_revenue, shopping_mall_revenueReported GMV attributed to the documented video, live, showcase, or marketplace channels; availability varies between list and detail results.
Affiliate and feedbackcommission_rate, product_review_countCommission percentage (for example, 25.0 means 25%) and number of product reviews.
Content and creatorsvideo_number, live_number, creator_numberCounts of associated videos, live broadcasts, and creators in detail results.
  • Compare ranked products’ unit sales, GMV, and growth over the selected dateRange.
    • Prompt example: “I am researching TikTok marketplace data. Could you compare ranked products’ unit sales, GMV, and growth over the selected dateRange? Show the returned values behind the comparison, and mark missing data.”
  • Examine whether a product’s reported sales come mainly from video, live, or other documented channels.
    • Prompt example: “I am researching TikTok marketplace data. Could you examine whether a product’s reported sales come mainly from video, live, or other documented channels? Show the relevant returned evidence and tell me what input you need from me.”
  • Filter to products associated with a specified video_id, livestream_id, shop, or creator and inspect their sales observations.
    • Prompt example: “I am researching TikTok marketplace data. Could you filter to products associated with a specified video_id, livestream_id, shop, or creator and inspect their sales observations? Show matching records and source links where the API provides them; ask me for any required identifier or filter.”
  • Review commission percentages, prices, and review counts when shortlisting affiliate products.
    • Prompt example: “I am researching TikTok marketplace data. Could you review commission percentages, prices, and review counts when shortlisting affiliate products? Show the relevant returned evidence and tell me what input you need from me.”
  • Use a ranking row’s product_id as productId for a detail lookup of its shop, category, and associated content counts.
    • Prompt example: “I am researching TikTok marketplace data. Could you use a ranking row’s product_id as productId for a detail lookup of its shop, category, and associated content counts? Show the relevant returned evidence and tell me what input you need from me.”

Ejemplo de datos

Ejemplo de solicitud y respuesta

Parámetros de solicitud

{
  "productId": "1734020651102734110",
  "region": "TH",
  "currency": "THB",
  "dateRange": "last30Day",
  "pageNumber": 1,
  "pageSize": 5
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": [
      {
        "sec_cate_id": "950792",
        "product_region": "th",
        "creator_number": 611,
        "video_revenue": 2203814.26,
        "sales_volumn": 30211,
        "video_number": 1970,
        "ter_cate_id": "951176",
        "unit_price": 73.24,
        "product_name": "AKCKแผ่นแปะสมุนไพรหอมระเหยจากพืช ช่วยผ่อนคลายจิตใจ สร้างบรรยากาศสบายก่อนนอน และบรรเทาความเจ็บปวดในยามค่ำคืน",
        "revenue": 2212535.2,
        "max_price": 201.73,
        "min_price": 84.47,
        "delivery_type": "local",
        "product_review_count": 9060,
        "product_id": "1734020651102734110",
        "pri_cate_id": "700645",
        "live_number": 222,
        "commission_rate": 11,
        "launch_date": "2026-01-16",
        "shopping_mall_revenue": 71.15,
        "product_description": [
          {
            "sub": [
              {
                "b": true,
                "t": "ฝ่ายบริการลูกค้า: หากคุณได้รับสินค้าที่เสียหาย จำนวนไม่ครบ หรือสินค้ามีตำหนิ โปรดติดต่อฝ่ายบริการลูกค้าของเราผ่านทางข้อความส่วนตัวใน TikTok ก่อนที่จะเขียนรีวิว และส่งรูปภาพของปัญหามาด้วย เราจะแก้ไขปัญหาให้คุณทันที!"
              }
            ],
            "text": "ฝ่ายบริการลูกค้า: หากคุณได้รับสินค้าที่เสียหาย จำนวนไม่ครบ หรือสินค้ามีตำหนิ โปรดติดต่อฝ่ายบริการลูกค้าของเราผ่านทางข้อความส่วนตัวใน TikTok ก่อนที่จะเขียนรีวิว และส่งรูปภาพของปัญหามาด้วย เราจะแก้ไขปัญหาให้คุณทันที!",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "วิธีใช้:"
              }
            ],
            "text": "วิธีใช้:",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "1. ลอกแผ่นฟิล์มออก"
              }
            ],
            "text": "1. ลอกแผ่นฟิล์มออก",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "2. ทาผลิตภัณฑ์ลงบนร่างกายของคุณ"
              }
            ],
            "text": "2. ทาผลิตภัณฑ์ลงบนร่างกายของคุณ",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "3. ลอกออกหลังจากตื่นนอน (ประมาณ 8-12 ชั่วโมง)"
              }
            ],
            "text": "3. ลอกออกหลังจากตื่นนอน (ประมาณ 8-12 ชั่วโมง)",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "4. แนะนำว่าไม่ควรใช้เกิน 48 ชั่วโมง มิเช่นนั้นผิวหนังอาจรับไม่ไหว (แตกต่างกันไปในแต่ละบุคคล)"
              }
            ],
            "text": "4. แนะนำว่าไม่ควรใช้เกิน 48 ชั่วโมง มิเช่นนั้นผิวหนังอาจรับไม่ไหว (แตกต่างกันไปในแต่ละบุคคล)",
            "type": "text"
          },
          {
            "sub": [
              {
                "t": "ชื่อผลิตภัณฑ์: แผ่นแปะช่วยนอนหลับ สรรพคุณ: ช่วยในการนอนหลับ จำนวน: 12 ชิ้น วัสดุ: ผ้าไม่ทอ อายุการใช้งาน: 3 ปี การเก็บรักษา: เก็บในที่แห้งและเย็น"
              }
            ],
            "text": "ชื่อผลิตภัณฑ์: แผ่นแปะช่วยนอนหลับ สรรพคุณ: ช่วยในการนอนหลับ จำนวน: 12 ชิ้น วัสดุ: ผ้าไม่ทอ อายุการใช้งาน: 3 ปี การเก็บรักษา: เก็บในที่แห้งและเย็น",
            "type": "text"
          },
          {
            "image": {
              "remove_gap": "false",
              "url_list": [
                "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
                "https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
              ],
              "width": 1728,
              "uri": "tos-alisg-i-aphluv4xwc-sg/d908990783624c5d9e106c582fb31d00",
              "height": 2304
            },
            "type": "image"
          },
          {
            "image": {
              "remove_gap": "false",
              "url_list": [
                "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
                "https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
              ],
              "width": 1728,
              "uri": "tos-alisg-i-aphluv4xwc-sg/a18f59aa845e4874983411919a78a34a",
              "height": 2304
            },
            "type": "image"
          },
          {
            "image": {
              "remove_gap": "false",
              "url_list": [
                "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086",
                "https://p19-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568&t=555f072d&ps=933b5bde&shp=a3510d86&shcp=6ce186a1&idc=my2&from=2739998086"
              ],
              "width": 1728,
              "uri": "tos-alisg-i-aphluv4xwc-sg/b07a49c754f846acb3e6d465e77ab4f9",
              "height": 2304
            },
            "type": "image"
          }
        ],
        "product_shop_id": "7494255174154028830",
        "live_revenue": 8649.8
      }
    ]
  }
}

API relacionadas