tiktok-shop/
search

Busque productos públicos de TikTok Shop por palabra clave y región de mercado, con campos normalizados de producto, vendedor, precio, contenido multimedia, calificación, reseñas y unidades vendidas.

TikTok Shop Search API

Descubrimiento de productos
Catálogos regionales
Señales comerciales
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 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ámetrosObligatorioDescripción
queryObligatorioPalabra clave o frase de producto obligatoria y no vacía.
results_limitOpcionalTope solicitado de resultados únicos, de 20 a 2,000. El valor predeterminado es 100.
regionOpcionalRegió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.

  1. Defina un query no vacío, elija una region admitida y establezca results_limit de 20 a 2,000.
  2. Envíe la solicitud por POST a /v1/tiktok-shop/search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

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

TikTok Shop Search API — FAQ

TikTok Shop Search API encuentra productos de acceso público a partir de una palabra clave y una región de mercado. Devuelve los campos normalizados de producto, vendedor, precio, contenido multimedia, categoría, SKU, calificación, cantidad de reseñas y unidades vendidas, cuando están expuestos.

No. TikTok Shop Search es un endpoint comercial independiente para productos públicos, mientras que TikTok Search descubre videos sociales públicos y contenido de creadores.

query es obligatorio, results_limit es un entero de 20 a 2,000 con un valor predeterminado de 100, y region tiene como valor predeterminado US.

Los valores admitidos son US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP e IE. La disponibilidad de productos fuera de US puede variar según el catálogo público de cada mercado.

Los resultados pueden incluir la identidad del producto y del vendedor, la URL canónica, la descripción, las imágenes, los datos de precio, las categorías, los SKU, el estado, la calificación, la cantidad de reseñas, las unidades vendidas, la región, la consulta y la hora de recopilación.

El mercado público seleccionado puede tener menos productos coincidentes, y la recopilación se detiene cuando ya no hay más páginas de origen disponibles tras la deduplicación. Por eso una tarea exitosa puede no contener elementos o contener menos de los solicitados.

Consulte /v1/tasks/{task_id}, lea data.results.items tras el éxito y solicite la siguiente página de resultados de la tarea con next_cursor mientras has_more sea true.

Cada producto normalizado devuelto cuesta 0.7 créditos de SocQ. Los resultados vacíos no tienen cargo por resultados.