Nexscope
🇪🇸 Español
🇺🇸English🇪🇸Español
Empieza gratis

API de detalles de vendedores de TikTok

Revisa ventas, seguidores, valoraciones, productos y contenido promocional de un vendedor de TikTok. Invoca la API mediante REST o MCP desde 10 créditos por llamada.

Coste10 créditos / llamada
Probar en línea
POST · https://api.nexscope.ai/et/sellerDetailMCP · nexscope_tiktok_seller_detail

Qué hace esta API

Revisar las ventas, seguidores, calificaciones, productos y contenido promocional de un vendedor TikTok.

Casos de uso de API de detalles de vendedores de TikTok

Investigar a un vendedor o tienda

Para investigar un vendedor o tienda, un analista de mercado presenta sellerId El código de error devuelto, errmsg, sellerId ayudar a identificar la tienda asociada con un producto candidato.

Comparar evidencia de producto de la tienda

Un analista de mercado utiliza TikTok Seller Detail con sellerId Para comparar la evidencia del producto de la tienda. sellerId ayudar a comparar productos o listados en tiendas preseleccionadas.

Tiendas de listas cortas para investigaciones ulteriores

Para este flujo de trabajo, un analista de mercado llama a TikTok Seller Detail con sellerId El resultado ayuda a elegir tiendas para un proveedor o un competidor.

Preguntas frecuentes sobre API de detalles de vendedores de TikTok

¿Qué hace el detalle del vendedor TikTok API ¿Volver?

Revisar las ventas, seguidores, calificaciones, productos y contenido promocional de un vendedor TikTok. `errcode`, `errmsg`, `sellerId`, `sellerName`, `sellerLink`, `coverUrl`, `region`, `categoryId`. Corresponde a los parámetros proporcionados sellerId. 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 detalle de vendedor TikTok API ¿costo?

El coste documentado actualmente es 10 créditos / llamada. 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 detalle del vendedor de TikTok? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /et/sellerDetail 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_seller_detail. 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 (en inglés)

Prueba esta API
Endpoint
https://api.nexscope.ai/et/sellerDetail
Método MCP
nexscope_tiktok_seller_detail

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/et/sellerDetail

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/et/sellerDetail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "sellerId": "7495514739648989419"
}'

Ejemplo de código

{
  "sellerId": "7495514739648989419"
}

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 la ausencia de una clave API (code 11209), 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.
Ver parámetros y respuestaProbar en línea
Todas las categorías/ Inteligencia de TikTok ET
POSThttps://api.nexscope.ai/et/sellerDetail

Ejecutar esta API

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

Abrir área de pruebas

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/et/sellerDetail
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
sellerIdstringobligatorio
TikTok Shop ID. Se puede obtener a partir de los resultados de la habilidad "ET TikTok Store Search" (`nexscope-et-list-seller`) o usando el ID de un enlace de tienda conocido. Longitud máxima 1000

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 (47 campos)

NombreTipoObligatorioDescripción
errcodeintegeropcional
Código de estado de negocio, 200 indica éxito (ver código de error para más detalles)
errmsgstringopcional
Descripción del estado de las actividades
costTokenintegeropcional
Consumir token
columnsarrayopcional
Definiciones de columna (muestra metadatos)
typestringopcional
Estilo renderizado (como `tableListWorkbenches`)
sellerIdstringopcional
ID de almacenamiento
sellerNamestringopcional
Nombre de la tienda
sellerLinkstringopcional
Almacenar enlace
coverUrlstringopcional
Dirección de la cubierta del almacén
regionstringopcional
área
categoryIdstringopcional
ID de clasificación del primer nivel
categoryL2Idstringopcional
ID de clasificación secundaria
categoryL3Idstringopcional
ID de clasificación de tercer nivel
totalSaleCntintegeropcional
ventas totales
totalSale1dCntintegeropcional
Volumen de ventas en el último día (incremental)
totalSale7dCntintegeropcional
Volumen de ventas en los últimos 7 días (incremental)
totalSale30dCntintegeropcional
Volumen de ventas en los últimos 30 días (incremental)
totalSale90dCntintegeropcional
Volumen de ventas en los últimos 90 días (incremental)
totalSaleGmvAmtnumberopcional
ventas totales
totalSaleGmv1dAmtnumberopcional
Ventas en el último día (incremental)
totalSaleGmv7dAmtnumberopcional
Ventas en los últimos 7 días (incremental)
totalSaleGmv30dAmtnumberopcional
Ventas en los últimos 30 días (incremental)
totalSaleGmv90dAmtnumberopcional
Ventas en los últimos 90 días (incremental)
followersCountintegeropcional
Número de fans
ratingnumberopcional
Calificación
reviewCountintegeropcional
Número de revisiones
positiveFeedbackRatenumberopcional
Valoración positiva
responseRatenumberopcional
tasa de respuesta
deliveryRateintegeropcional
Tasa de ejecución
totalProductCntintegeropcional
Número histórico de artículos en la tienda (incluyendo la eliminación de estantes)
totalCrawlProductCntintegeropcional
Número de artículos en almacén
spuAvgPricenumberopcional
Precio medio del producto SKU en el almacén
minPriceintegeropcional
precio más bajo
maxPriceintegeropcional
precio más alto
totalIflCntintegeropcional
Número total de personas que transportan mercancías
totalVideoCntintegeropcional
Número total de vídeos entregados
totalLiveCntintegeropcional
Total de emisiones en directo
salesFlagTextstringopcional
Principales métodos de entrega (entrega de vídeo / entrega en vivo)
salesTrendFlagTextstringopcional
Evolución de las ventas (aumento/declining/stable)
shopIdentityLabelstringopcional
Almacenar el logotipo (como la tienda oficial)
shopTypeTextstringopcional
Si es una tienda de marca (sí/no)
fromFlagTextstringopcional
Identificación transfronteriza (doméstica/transfronteriza)
productCategoryListstringopcional
Categoría de producto (JSON cadena, incluidos category_name / category_id)
mostProductCategoryListstringopcional
Clasificación de productos TOP1 (JSON string)
firstCrawlDtintegeropcional
Tiempo estimado de lanzamiento, yyyyMMdd formato (como 20240504 representa 2024-05-04)
userIdstringopcional
Maestro UID
sourceTypestringopcional
Fuente del producto (como TikTok)

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 la ausencia de una clave API (code 11209), 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_seller_detail",
    "arguments": {
      "sellerId": "7496162162184128712"
    }
  }
}

Ejemplo de datos

Parámetros de solicitud

{
  "region": "US",
  "sellerId": "8650766540691773721"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "totalSale30dCnt": 0,
    "categoryL3Id": "601302",
    "totalSale1dCnt": 0,
    "salesTrendFlagText": "平稳",
    "rating": 4.8,
    "type": "tableListWorkbenches",
    "salesFlagText": "视频带货",
    "totalSale90dCnt": 0,
    "totalIflCnt": 1,
    "sellerId": "8650766540691773721",
    "sourceTool": "EchoTik-店铺详情",
    "shopTypeText": "否",
    "reviewCount": 0,
    "totalSaleCnt": 653,
    "totalSaleGmv1dAmt": 0,
    "totalSaleGmv90dAmt": 0,
    "fromFlagText": "本土",
    "totalSaleGmv30dAmt": 0,
    "firstCrawlDt": 20261002,
    "coverUrl": "https://agent-files.linkfox.com/tiktok/20261003/8650766540691773721.jpg",
    "sourceType": "Tiktok",
    "minPrice": 65,
    "followersCount": 0,
    "maxPrice": 65,
    "region": "ES",
    "spuAvgPrice": 65.37,
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "sellerId",
        "sortable": true,
        "title": "小店ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sellerName",
        "sortable": true,
        "title": "小店名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sellerLink",
        "sortable": true,
        "title": "小店链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "coverUrl",
        "sortable": true,
        "title": "店铺封面地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "region",
        "sortable": true,
        "title": "地区"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "categoryId",
        "sortable": true,
        "title": "一级分类ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "categoryL2Id",
        "sortable": true,
        "title": "二级分类ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "categoryL3Id",
        "sortable": true,
        "title": "三级分类ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productCategoryList",
        "sortable": true,
        "title": "商品分类"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "mostProductCategoryList",
        "sortable": true,
        "title": "TOP1商品分类"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "fromFlagText",
        "sortable": true,
        "title": "跨境标识"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "salesFlagText",
        "sortable": true,
        "title": "主要带货方式"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "salesTrendFlagText",
        "sortable": true,
        "title": "销售趋势"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopTypeText",
        "sortable": true,
        "title": "是否品牌店铺"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopIdentityLabel",
        "sortable": true,
        "title": "店铺标识"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "rating",
        "sortable": true,
        "title": "评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewCount",
        "sortable": true,
        "title": "评价数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "positiveFeedbackRate",
        "sortable": true,
        "title": "好评率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "responseRate",
        "sortable": true,
        "title": "回复率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "deliveryRate",
        "sortable": true,
        "title": "送达率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "followersCount",
        "sortable": true,
        "title": "粉丝数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "minPrice",
        "sortable": true,
        "title": "最低价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "maxPrice",
        "sortable": true,
        "title": "最高价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "spuAvgPrice",
        "sortable": true,
        "title": "店铺内商品SKU均价"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalCrawlProductCnt",
        "sortable": true,
        "title": "在店商品数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalProductCnt",
        "sortable": true,
        "title": "历史在店商品数(含下架)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalIflCnt",
        "sortable": true,
        "title": "总带货达人数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalLiveCnt",
        "sortable": true,
        "title": "总直播数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalVideoCnt",
        "sortable": true,
        "title": "总带货视频数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSaleCnt",
        "sortable": true,
        "title": "总销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSale1dCnt",
        "sortable": true,
        "title": "最近1天销量(增量)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSale7dCnt",
        "sortable": true,
        "title": "最近7天销量(增量)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSale30dCnt",
        "sortable": true,
        "title": "最近30天销量(增量)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSale90dCnt",
        "sortable": true,
        "title": "最近90天销量(增量)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSaleGmvAmt",
        "sortable": true,
        "title": "总销售额"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSaleGmv1dAmt",
        "sortable": true,
        "title": "最近1天销售额(增量)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSaleGmv7dAmt",
        "sortable": true,
        "title": "最近7天销售额(增量)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSaleGmv30dAmt",
        "sortable": true,
        "title": "最近30天销售额(增量)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSaleGmv90dAmt",
        "sortable": true,
        "title": "最近90天销售额(增量)"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "userId",
        "sortable": true,
        "title": "达人UID"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "firstCrawlDt",
        "sortable": true,
        "title": "预估上架时间"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "商品来源"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "type",
        "sortable": true,
        "title": "渲染的样式"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "columns",
        "sortable": true,
        "title": "渲染的列"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "costToken",
        "sortable": true,
        "title": "消耗token"
      }
    ],
    "sellerName": "OrinBliss",
    "totalSaleGmv7dAmt": 0,
    "shopIdentityLabel": "",
    "totalProductCnt": 1,
    "totalSaleGmvAmt": 42686.61,
    "mostProductCategoryList": "[]",
    "totalVideoCnt": 1,
    "totalLiveCnt": 0,
    "userId": "7686331493279040534",
    "totalSale7dCnt": 0,
    "productCategoryList": "[]",
    "totalCrawlProductCnt": 9,
    "sellerLink": "aweme://user/profile/7686331493279040534?sec_uid=MS4wLjABAAAAe9aj3K3gx6wKcDw7_bymjjiVKimHeif3heLjIQ0piVppZM5RyCBig6YaWEnfSaKL&from_scene=8",
    "categoryL2Id": "842248",
    "categoryId": "601152"
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

10 créditos / llamadaRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint
/et/sellerDetail
Método de MCP
nexscope_tiktok_seller_detail
cURL
curl -X POST \
  https://api.nexscope.ai/et/sellerDetail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "sellerId": "7495514739648989419" }'
Respuesta
Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

API relacionadas

TikTok Shop API De Detalles De Vídeos De Tik Tok Por Lotes

Retrieve details for several TikTok videos in one request to compare their content and available performance information.

TikTok Shop API De Vídeos De Productos De Tik Tok

Find videos associated with a TikTok product to research how creators promote the item and review available video information.

TikTok Shop API De Búsqueda De Vendedores De Tik Tok

Find TikTok sellers by region and available sorting options to research shops and identify relevant competitors.

TikTok Shop API De Productos De Vendedores De Tik Tok

List the products offered by a TikTok seller to review their assortment and compare available product information.