tiktok-shop/
search-suggestions

Obtenga las sugerencias con que TikTok Shop completa el inicio de una búsqueda de compras en el mercado elegido, con hasta 20 frases de palabras clave numeradas desde 1 junto con su consulta y su región.

TikTok Shop Search Suggestions API

Consulta parcial
Hasta 20 sugerencias
Numeradas desde 1
0.5 créditos por solicitud
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 Suggestions

Las sugerencias de búsqueda de TikTok Shop son las frases con que el buscador de la tienda completa lo que escribe quien compra, cada una con su posición en la lista y el mercado en el que se sugirió. Como nacen de lo que la gente busca de verdad, estas frases revelan variantes de producto, modelos compatibles y motivos de compra que conviene incluir en títulos de productos, anuncios y contenido.

Funcionalidades de la TikTok Shop Search Suggestions API

  • Sugerencias para una búsqueda incompletaquery recibe las primeras palabras de una búsqueda, como phone case, y cada fila devuelve una frase más larga con la que la completan los compradores, como phone cases 17 pro max.
  • El orden de sugerencias de TikTok Shoprank numera las sugerencias desde 1 en el orden en que las muestra TikTok Shop, con hasta 20 por consulta.
  • Sugerencias por mercadoregion elige uno de US, SG, MY, PH, TH, VN, ID, JP y MX, con US como valor predeterminado, y cada fila repite su query y su region para que los resultados sean rastreables.

Parámetros de la TikTok Shop Search Suggestions API

ParámetrosObligatorioDescripción
queryObligatorioEl inicio de una búsqueda de compras que se quiere completar, como phone case.
regionOpcionalMercado de búsqueda: US, SG, MY, PH, TH, VN, ID, JP o MX. El valor predeterminado es US.

Cómo usar la TikTok Shop Search Suggestions API

Envíe las primeras palabras de una búsqueda de compras y lea las sugerencias en orden.

  1. Envíe {"query": "phone case", "region": "US"} por POST a /v1/tiktok-shop/search-suggestions.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea keyword y rank en results.items; cuando has_more sea true, obtenga el resto con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"phone case","region":"US"}'

Casos de uso de la TikTok Shop Search Suggestions API

  • Elegir palabras clave para títulos de productos: Escoja las frases de keyword que mencionan modelos, tallas o variantes e inclúyalas en los títulos y las descripciones de sus productos.
  • Armar conjuntos de palabras clave para anuncios y contenido: Reúna la columna keyword de varias consultas semilla para formar listas de palabras clave para anuncios, descripciones de videos y planificación de contenido.
  • Seguir cómo cambian las sugerencias: Vuelva a ejecutar la misma query y region a lo largo del tiempo y compare el rank de cada keyword para ver qué frases suben, bajan o aparecen por primera vez.
  • Comparar cómo completa cada mercado una búsqueda: Envíe una misma query a varias regiones y ponga las listas de keyword lado a lado para ver cómo completan las mismas palabras los compradores de cada mercado.

Consejos de expertos para la TikTok Shop Search Suggestions API

  • Use como semilla una raíz corta en lugar de una frase completa, porque las sugerencias amplían el inicio de la consulta y una frase larga deja poco por completar.
  • Baje un nivel más enviando un keyword devuelto como nueva query, lo que convierte una semilla en un árbol de frases más largas.
  • Elimine duplicados por keyword, que además es el id de la fila, al combinar resultados de varias semillas, ya que raíces relacionadas pueden devolver la misma frase.
  • Pase un keyword prometedor a TikTok Shop Search con la misma region para ver los productos detrás de esa sugerencia.

Además de la TikTok Shop Search Suggestions 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 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 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 Search Suggestions API — FAQ

TikTok Shop Search Suggestions API es una interfaz programática para obtener las sugerencias de búsqueda que TikTok Shop ofrece para el inicio de una consulta de compras en un mercado. Devuelve hasta 20 frases de palabras clave sugeridas, cada una con su posición, la consulta original y la región.

Cada solicitud recibe una query. Para cubrir varias palabras clave semilla, envíe una solicitud por semilla y combine los resultados por keyword.

Cada llamada cuesta 0.5 créditos y devuelve hasta 20 sugerencias; el precio es por llamada, no por sugerencia.