tiktok-shop/
products

Recopile productos públicos de la URL de una tienda de TikTok Shop, con identidad, precios, imágenes, contexto del vendedor, calificaciones, reseñas y unidades vendidas como registros normalizados.

TikTok Shop Products API

Una URL de tienda
Más vendidos o novedades
20–2,000 productos solicitados
Registros de producto normalizados
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Shop Products

Los productos de TikTok Shop son artículos públicos del catálogo de una tienda, con identidad del producto, contexto del vendedor, imágenes, precios, categorías, datos de SKU, calificaciones, cantidad de reseñas y unidades vendidas. Estos registros sirven para tomar instantáneas del catálogo de una tienda, comparar surtidos, monitorear precios públicos y enriquecer a nivel de producto.

Funcionalidades de la TikTok Shop Products API

  • Controles de catálogo por tiendaRecopile productos de la URL de una tienda pública admitida con un límite de resultados solicitado, un orden por más vendidos o por novedades, y una región de mercado documentada.
  • Identidad de producto, vendedor y contenido multimediaDevuelve en cada registro los ID de producto, los títulos, las descripciones disponibles, las URL canónicas, la identidad del vendedor o de la tienda, y las referencias de imágenes públicas sin duplicados.
  • Precios y señales comerciales visiblesConserva los precios de venta y originales expuestos, la moneda, los valores con formato, los descuentos, las calificaciones, la cantidad de reseñas y las unidades vendidas para comparar productos.
  • Filas de catálogo estructuradasMantiene el estado, la categoría y las estructuras de SKU disponibles en filas de producto normalizadas, y excluye los contadores a nivel de tienda que no están asociados a un producto individual.

Parámetros de la TikTok Shop Products API

ParámetrosObligatorioDescripción
urlObligatorioURL pública obligatoria de una tienda de TikTok Shop que coincida con /shop/store/{slug}/{numeric_shop_id}; una tarea acepta una tienda.
results_limitOpcionalMáximo de productos únicos que se guardan entre las páginas de origen; el valor predeterminado es 100 y acepta enteros de 20 a 2,000.
sort_byOpcionalOrden de origen del catálogo de la tienda: top para el orden por más vendidos o new_releases para el orden por lanzamientos más recientes; el valor predeterminado es top.
regionOpcionalRegión de mercado de TikTok Shop; el valor predeterminado es US, y la disponibilidad pública del catálogo en otras regiones aceptadas puede variar.

Cómo usar la TikTok Shop Products API

Envíe la URL de una tienda pública de TikTok Shop con controles de recopilación opcionales, siga la tarea asíncrona y lea los registros de producto normalizados con paginación por cursor.

  1. Prepare una URL /shop/store/{slug}/{numeric_shop_id} admitida y elija los valores de results_limit, sort_by y region.
  2. Envíe la solicitud por POST a /v1/tiktok-shop/products y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y solicite el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la TikTok Shop Products API

  • Instantáneas del catálogo de una tienda: Use los ID de producto, los títulos, las URL, los vendedores, los precios, las imágenes, las categorías, las estructuras de SKU y collected_at para armar un catálogo público de una tienda en un momento dado.
  • Comparación de surtidos de más vendidos y novedades: Recopile la misma tienda con los órdenes top y new_releases y compare la identidad de los productos devueltos, los precios, las categorías y las señales visibles de los productos.
  • Seguimiento de precios y señales públicas: Compare los campos de precio, descuento, calificación, cantidad de reseñas, unidades vendidas, estado y hora de recopilación obtenidos de forma independiente para los mismos ID de producto.
  • Preparación de una lista corta de URL de productos: Use las URL canónicas de los productos, los títulos, las imágenes, el contexto del vendedor y las métricas visibles para elegir productos devueltos que pasen a flujos de detalle o de reseñas.

Consejos de expertos para la TikTok Shop Products API

  • Valide antes de enviar la tarea que la entrada use una ruta pública /shop/store/ de tiktok.com con un ID de tienda numérico.
  • Defina region con el mercado de la tienda que quiere inspeccionar; cuando una tienda válida no devuelva registros, verifique la disponibilidad regional antes de reintentar.
  • Use top para el orden de más vendidos del origen o new_releases para el orden de lanzamientos más recientes, y no interprete ninguno de los dos modos como una garantía de rentabilidad ni de tendencia.
  • Trate results_limit como el máximo de recopilación y siga el cursor independiente del resultado de la tarea hasta que has_more sea false para leer todas las filas guardadas.
  • Identifique las instantáneas repetidas por ID de producto, conserve collected_at y maneje los campos de vendedor, precio, estado, categoría, SKU, contenido multimedia y métricas como opcionales.

Además de la TikTok Shop Products API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Shop.

  • TikTok Shop Search API — Busca productos públicos de TikTok Shop por palabra clave y región de mercado, con campos de vendedor, precio, contenido multimedia, calificación, reseñas y cantidad vendida.
  • TikTok Shop Product API — Obtiene un producto público de TikTok Shop desde la URL de su página de producto, con campos de vendedor, precio, contenido multimedia, categoría, SKU, calificación, reseñas y cantidad vendida.
  • TikTok Shop Product Reviews API — Recolecta reseñas públicas de la URL de la página de un producto de TikTok Shop, con campos de texto, calificación, autor, imagen, SKU, país y contexto de compra.
  • TikTok Shop User Showcase API — Recolecta los productos públicos de la vitrina de un nombre de usuario de TikTok, con precio, vendedor, contenido multimedia, calificación, reseñas, cantidad vendida y contexto regional.
  • TikTok Shop Hot Products API — Recolecta los productos más vendidos de un mercado de TikTok Shop por código de región, en el orden de la clasificación, con precio, moneda, unidades vendidas, calificación y tienda.
  • TikTok Shop Categories API — Obtiene el árbol completo de categorías de un mercado de TikTok Shop con IDs, nombres, slugs en inglés, niveles, categorías padre y rutas.

Explorar otras plataformas

Combine los datos de TikTok Shop con datos públicos de otras plataformas sociales compatibles.

TikTok Shop Products API — FAQ

TikTok Shop Products API recopila registros de productos públicos de la URL de una tienda de TikTok Shop admitida. Devuelve la identidad del producto, el contexto del vendedor, los precios, las imágenes, las categorías, los datos de SKU, las calificaciones, la cantidad de reseñas, las unidades vendidas y la hora de recopilación, todo normalizado.

url debe usar tiktok.com o un subdominio de TikTok y coincidir con /shop/store/{slug}/{numeric_shop_id}. La solicitud también acepta results_limit de 20 a 2,000, sort_by como top o new_releases, y un valor de region documentado.

top solicita el orden de más vendidos del origen, mientras que new_releases solicita el orden de lanzamientos más recientes. Son modos de ordenamiento del origen y no garantizan rentabilidad, estado de tendencia ni una clasificación completa del inventario.

Cada fila normalizada puede incluir la identidad del producto y del vendedor, una URL canónica, el título o la descripción, las imágenes, los precios, el descuento, la calificación, la cantidad de reseñas, las unidades vendidas, el estado, las categorías, los SKU, la URL de entrada, la región y la hora de recopilación. Los contadores a nivel de tienda que quedan fuera de las filas de productos individuales no forman parte del contrato del registro normalizado.

results_limit es un máximo y no una cantidad garantizada. La recopilación se detiene cuando la región seleccionada no expone más productos ni otro cursor, y los ID de producto expuestos que se repiten se guardan una sola vez por tarea.

Cuando la tarea tenga éxito, lea data.results.items de GET /v1/tasks/{task_id}. Mientras has_more sea true, pase next_cursor al mismo endpoint de tareas hasta que has_more pase a false.

Cada registro de producto devuelto cuesta 0.7 créditos de SocQ. La estimación de la solicitud usa results_limit, o 100 cuando se omite, y un conjunto de resultados vacío no tiene cargo por resultados.