TikTok Shop Search
Los resultados de TikTok Shop Search son productos públicos que coinciden con una palabra clave en un mercado seleccionado, con identidad del producto y del vendedor, precios, imágenes, calificaciones, cantidad de reseñas y unidades vendidas. Estos registros comerciales sirven para descubrir productos por región, comparar precios, investigar vendedores y obtener instantáneas de mercado repetibles.
Funcionalidades de la TikTok Shop Search API
- Control de palabra clave y mercadoCombine una consulta de producto con uno de los 16 valores de region admitidos para buscar en el catálogo público del mercado previsto.
- Recopilación única y acotadaSolicite de 20 a 2,000 resultados mientras las páginas de la recopilación se deduplican por identidad pública del producto.
- Identidad de producto y vendedorDevuelve los ID de producto, los títulos, las descripciones, los enlaces canónicos y los datos expuestos del vendedor o de la tienda.
- Precios y señales comerciales visiblesConserva el precio de venta, el precio original, la moneda, el descuento, la calificación, la cantidad de reseñas y las unidades vendidas cuando están expuestos.
- Contexto de contenido multimedia y productoMantiene con cada registro las imágenes públicas, las categorías, las estructuras de SKU, el estado, la consulta de búsqueda, la región y la hora de recopilación.
Parámetros de la TikTok Shop Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave o frase de producto obligatoria y no vacía. |
results_limit | Opcional | Tope solicitado de resultados únicos, de 20 a 2,000. El valor predeterminado es 100. |
region | Opcional | Región de mercado: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP o IE. El valor predeterminado es US. |
Cómo usar la TikTok Shop Search API
Elija una frase de producto concreta y un mercado, y luego envíe una solicitud de búsqueda asíncrona.
- Defina un query no vacío, elija una region admitida y establezca results_limit de 20 a 2,000.
- Envíe la solicitud por POST a /v1/tiktok-shop/search y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- Lea data.results.items. Cuando has_more sea true, continúe con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la TikTok Shop Search API
- Descubrimiento de productos por región: Mapee los productos públicos que coinciden con una categoría, una necesidad, una marca o una frase de producto en un mercado seleccionado.
- Comparación de precios y descuentos: Compare el precio de venta, el precio original, la moneda y los campos de descuento disponibles entre los productos devueltos.
- Comparación de reputación y demanda: Compare las calificaciones, la cantidad de reseñas y las unidades vendidas expuestas, sin convertir las métricas ausentes en cero.
- Selección de productos y tiendas: Use los enlaces de producto, la identidad del vendedor, las imágenes, las categorías y el contexto de SKU para elegir candidatos para una revisión más profunda.
Consejos de expertos para la TikTok Shop Search API
- Guarde siempre query y region juntos, porque la misma frase puede resolverse en catálogos públicos distintos.
- Defina results_limit según el volumen que necesite y siga next_cursor hasta que has_more sea false para leer el resultado completo de la tarea.
- Trate un precio, una calificación, una cantidad de reseñas o unas unidades vendidas ausentes como no disponibles y no como cero.
- Conserve search_query y collected_at en cada registro para que las instantáneas regionales se puedan reproducir.
- Pase la URL PDP elegida a TikTok Shop Product API cuando necesite un enriquecimiento reciente a nivel de detalle.
APIs relacionadas
Además de la TikTok Shop Search API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Shop.
- TikTok Shop Products API — Recolecta productos públicos de la URL de una tienda de TikTok Shop, con campos de vendedor, precio, contenido multimedia, categoría, SKU, 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 Search Suggestions API — Obtiene hasta 20 sugerencias numeradas que TikTok Shop ofrece para completar el inicio de una búsqueda de compras en un mercado.