Documentos
Ctrl+K Buscar Alt+[Alt+] Guías
Obtener clave API

API · TikTok Shop

API de TikTok Shop: filtros y parámetros de consulta

Esta referencia está dirigida a los integradores que llaman a /api/v1/tiktok-shop/* con un Clave API, o las mismas formas de ruta en /api/tiktok-shop/... una vez iniciada la sesión sesión del navegador. Lista de rutas HTTP y comportamiento general: Referencia de la API.

Cómo se envían los parámetros

Mecanismo Detalles
Cadena de consulta Lo habitual para GET.
ENVIAR JSON En las rutas «explore» y «count» que admiten POST, el objeto JSON incluido en el cuerpo se combina con los parámetros de consulta (con las mismas claves que en las tablas siguientes). Utiliza esta opción cuando los conjuntos de filtros sean muy grandes (para evitar el error 414 «URI demasiado largo»).
Formulario POST application/x-www-form-urlencoded El cuerpo también se incluye en «params».
Omitido / vacío Cadena vacía, null, o la cadena literal «sin definir» se eliminan y, por lo general, se ignoran.

Explora y cuenta (categorías, tiendas, creadores, vídeos, productos)

Esto se corresponde con:

Sufijo de ruta (en /api/v1/tiktok-shop/) Objetivo
categorías/explorar, categorías/número Mostrar o filtrar categorías / contar coincidencias
tiendas/explorar, tiendas/número Ver o buscar tiendas / contar resultados
creadores/explorar, creadores/número Mostrar o buscar creadores / contar coincidencias
vídeos/explorar, vídeos/número Ver o buscar vídeos / contar coincidencias
productos/descubrir, productos/cantidad Ver o buscar productos / contar resultados

Paginación y ordenación (solo para explorar; no se envía en el recuento)

Parámetro Por defecto Notas
página 1 Página de números enteros.
límite 20 Tamaño de la página.
después de — Cursor opaco del conjunto de teclas (paginación hacia adelante).
incluir_total — Si está presente, se reenvía al servidor de origen.
salto de punto de control — Si está presente, se reenvía al servidor de origen.
clasificar Consulte la opción «default_sort » por entidad a continuación Upstream asigna campos de ordenación específicos para cada período.
pedido desc Dirección de ordenación.

Ámbito de la categoría (explorar y contar, cuando tiene_jerarquía_de_categorías (es cierto)

Parámetro Notas
ID de categorías Separados por comas o en forma de matriz; combinados con los identificadores de nivel que figuran a continuación.
id_de_categoría_l1, id_de_categoría_l2, id_de_categoría_nivel_3 Un único identificador; varios alias id_de_categoría_nivel_1, id_de_categoría_l2, id_de_categoría_l3 también se aceptan.
excluir_ids_de_categoría Lista separada por comas que se debe excluir.

Valores

Parámetro Por defecto
país EE. UU.

específicos de entidad

Cada entidad expone un conjunto de filtros incluidos en la lista de permitidos. Las solicitudes utilizan nombres de parámetros canónicos; los alias admiten nombres alternativos (con el mismo valor).

Categorías — ordenación predeterminada: origen de los ingresos

Filtros
país, nivel, ID de categorías, nombre, período, ingresos mínimos, ingresos máximos, ingresos_mínimos_por_tienda, ingresos_máximos_por_tienda, porcentaje_mínimo_de_las_3_tiendas_más_vendidas, proporción máxima de las tres tiendas principales, porcentaje_mínimo_de_las_10_tiendas_más_vendidas, porcentaje_máximo_de_las_10_tiendas_más_vendidas, número_mínimo_de_tiendas, número máximo de tiendas, número_mínimo_de_vídeos, número_máximo_de_vídeos

Alias: ingresos mínimos ← ingresos_mínimos_30_días; ingresos máximos ← ingresos_máximos_en_30_días.

Tiendas — ordenación predeterminada: ingresos

Filtros
país, nombre, período, ID de categorías, ingresos mínimos, ingresos máximos, tasa_mínima_de_crecimiento_de_los_ingresos, tasa_máxima_de_crecimiento_de_los_ingresos, tasa_mínima_de_crecimiento_de_las_ventas, tasa_máxima_de_crecimiento_de_las_ventas, visto por primera vez, puntuación mínima, puntuación máxima, tipo de vendedor, número_mínimo_de_productos, número máximo de productos, precio_unitario_mínimo_promedio, precio_unitario_máximo_promedio, número_mínimo_de_creadores, número_máximo_de_creadores, número_mínimo_de_vídeos, número_máximo_de_vídeos, porcentaje_de_canales_gestionados_por_la_propia_empresa, porcentaje_máximo_de_canales_gestionados_de_forma_autónoma

Alias: ingresos mínimos ← min_gmv_30d; ingresos máximos ← max_gmv_30d; tasa_mínima_de_crecimiento_de_los_ingresos ← tasa_de_crecimiento_del_GMV_en_los_últimos_30_días; tasa_máxima_de_crecimiento_de_los_ingresos ← tasa_de_crecimiento_del_GMV_en_los_últimos_30_días; precio_unitario_mínimo_promedio ← precio_médio_mínimo; precio_unitario_máximo_promedio ← precio_promedio_máximo.

Creadores — ordenación predeterminada: ingresos

Filtros
país, nombre, período, ID de categorías, ingresos mínimos, ingresos máximos, tasa_mínima_de_crecimiento_de_los_ingresos, tasa_máxima_de_crecimiento_de_los_ingresos, tasa_de_crecimiento_mínima_de_seguidores, tasa_máxima_de_crecimiento_de_seguidores, tasa_de_crecimiento_de_las_visualizaciones_mínima, tasa_máxima_de_crecimiento_de_visualizaciones, número mínimo de seguidores, número máximo de seguidores, número mínimo de visitas, máximo de visitas, verificado, número_mínimo_de_productos, número máximo de productos, número_mínimo_de_vídeos, número_máximo_de_vídeos

Alias: ingresos mínimos ← min_gmv_30d; ingresos máximos ← max_gmv_30d.

Vídeos — ordenación predeterminada: ingresos

Filtros
país, nombre, período, ID de categorías, ingresos mínimos, ingresos máximos, tasa_mínima_de_crecimiento_de_los_ingresos, tasa_máxima_de_crecimiento_de_los_ingresos, tasa_de_crecimiento_de_las_visualizaciones_mínima, tasa_máxima_de_crecimiento_de_visualizaciones, tasa_de_crecimiento_mínima_de_«me gusta», tasa_máxima_de_crecimiento_de_los_«Me gusta», tasa_mínima_de_crecimiento_de_las_acciones, tasa_máxima_de_crecimiento_de_las_acciones, número mínimo de visitas, máximo de visitas, duración mínima, duración máxima, ROAS mínimo, max_roas, gasto_mínimo_en_publicidad, gasto_máximo_en_publicidad, mín. de «Me gusta», máximo de «Me gusta», número mínimo de seguidores del creador, máximo de seguidores del creador, fecha de publicación, es un anuncio, es_afiliado, ¿Es autopromoción?, is_ai_ugc, tendencia de ingresos

Productos — ordenación predeterminada: ingresos

Filtros
país, nombre, período, ID de categorías, ingresos mínimos, ingresos máximos, tasa_mínima_de_crecimiento_de_los_ingresos, tasa_máxima_de_crecimiento_de_los_ingresos, tasa_mínima_de_crecimiento_de_las_ventas, tasa_máxima_de_crecimiento_de_las_ventas, número mínimo de artículos vendidos, máximo de artículos vendidos, número_mínimo_de_unidades_vendidas, número máximo de unidades vendidas, precio_unitario_mínimo_promedio, precio_unitario_máximo_promedio, porcentaje_mínimo_de_comisión, porcentaje_máximo_de_comisión, puntuación_mínima_del_producto, puntuación máxima del producto, número_mínimo_de_opiniones_sobre_el_producto, número máximo de reseñas de productos, número_mínimo_de_creadores, número_máximo_de_creadores, fecha_mínima_de_lanzamiento_del_producto, fecha_máxima_de_lanzamiento_del_producto, porcentaje_mínimo_de_conversión_del_creador, porcentaje_máximo_de_conversión_del_creador, visto por primera vez, precio_mínimo, precio_máximo

Alias: número mínimo de artículos vendidos ← mín. vendido; máximo de artículos vendidos ← máximo vendido.

Permitido clasificar valores

Las claves de ordenación son no se detallan exhaustivamente en este documento; el servicio de análisis de origen asigna claves de ordenación genéricas a campos específicos de cada periodo. Tratar clasificar como una cadena opaca alineada con la interfaz de usuario del filtro de la aplicación web, o bien examinar las llamadas de red desde el panel de control para esa misma entidad.

exclusivos del panel de control#

No utilices para la medición los indicadores de consulta del panel que no estén documentados. En el caso de las integraciones de API, envía únicamente los filtros descritos anteriormente y sigue las instrucciones de la sección «Créditos y facturación».

GET /api/v1/tiktok-shop/products

Parámetros de consulta (todos opcionales, excepto «auth»):

Parámetro Por defecto
página 0
límite 20
clasificar descripción_ventas
categoría, precio_mínimo, precio_máximo, ventas mínimas, ventas máximas, puntuación mínima, fecha_de_inicio, fecha_hasta, buscar, país —

GET /api/v1/tiktok-shop/search (Buscar productos)

Parámetro Obligatorio
q Sí (cadena de búsqueda)
página No (0 (por defecto)
límite No (20 (por defecto)
categoría No

GETtrending (obtenerProductosDeTendencia)

Parámetro Por defecto
límite 10
plazo 7 días
categoría —

GET /api/v1/tiktok-shop/shop-details / tiendas/detalles (Obtener detalles de la tienda)

Parámetro Obligatorio
id Sí — identificador de tienda

GET /api/v1/tiktok-shop/suggestions (sugerencias)

Parámetro Obligatorio Notas
tipo Sí Una de las siguientes opciones: categorías, tiendas, creadores, productos, vídeos.
q Sí Nombre parcial; si se deja en blanco, no se muestran sugerencias.
límite No 1–20, por defecto 10.
país No Por defecto EE. UU..

Jerarquía y estáticas#

Ruta Parámetros
categorías/jerarquía, categorías/capas país (por defecto EE. UU.).
categorías/resumen, categorías/historia, … Principalmente OBTENER parámetros de consulta (país, ids, periodo, …); consulta la pestaña «Red» de la aplicación para ver la estructura exacta de cada ruta.

Para PUBLICAR organismos en rutas específicas (detalles de la tienda, detalles del producto, etc.), cada ruta tiene su propio formato JSON: captura una solicitud desde el panel de control para la pestaña que necesites y, a continuación, reprodúcela en /api/v1/tiktok-shop/... con tu clave API.

Herramientas MCP (mismos datos que en «Explorar»)

Si utilizas Protocolo de contexto de modelos (Claude Desktop, etc.), las herramientas de TikTok emiten el las mismas cargas útiles de exploración/recuento La API HTTP admite — la misma semántica de filtrado tal y como se indica en este documento, cuando proceda (palabra clave, país, página, tamaño frente a HTTP límite, límites de ingresos o precios de los productos, …).

Herramienta MCP Mapas de
buscar_productos_en_TikTok productos/descubrir
buscar_en_TikTok_Shops tiendas/explorar
buscar_creadores_de_TikTok creadores/explorar
buscar_vídeos_en_TikTok vídeos/explorar
número de entidades de TikTok Cuenta los resultados que coinciden con los mismos filtros utilizados en el explorar parámetros.
explorar_categorías_de_TikTok, lista_categorías_más_populares_de_TikTok, autocompletar_tiktok Jerarquía de categorías / niveles / resumen / historial / elementos del mismo nivel / listas de los más populares / sugerencias
obtener_producto_de_TikTok, get_tiktok_shop, obtener_creador_de_TikTok, obtener_vídeo_de_TikTok Detalles y segmentación de cargas útiles (métricas, historial, listas, estrategia): consulta la referencia de herramientas de MCP
obtener_productos_de_tendencia_en_TikTok Es lo mismo que GETtrending (apartado siguiente)
ver créditos Es lo mismo que GET /api/v1/tiktok-shop/credits

Nombres completos de los argumentos: MCP · Referencia de herramientas.

¿Qué es lo que hay que tener en cuenta

Preocupación Ubicación
Lista de rutas (rutas + verbos) Referencia de la API — Sección TikTok Shop
Filtros y cuerpos (este documento) Las tablas anteriores
Detalles de la entidad (cuerpos JSON) Detalles de TikTok Shop
ce](/docs/api) — Sección TikTok Shop
Filtros y cuerpos (este documento) Las tablas anteriores + capturas de red dentro de la aplicación para casos extremos