youtube/
search-suggestions

Obtenga las sugerencias de autocompletado que ofrece el cuadro de búsqueda de YouTube para una consulta parcial, en el orden en que las ven los usuarios, para el idioma y la región que elija.

YouTube Search Suggestions API

Autocompletado
Idioma y región
Precio fijo por solicitud
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

YouTube Search Suggestions

Las sugerencias de búsqueda son las frases que el cuadro de búsqueda de YouTube propone para completar mientras alguien todavía está escribiendo, ordenadas según el idioma y el país de esa persona. Revelan cómo se formula realmente la demanda en torno a un término inicial, lo que las convierte en una fuente directa para investigar palabras clave, títulos de videos, etiquetas e ideas de contenido.

Funcionalidades de la YouTube Search Suggestions API

  • El orden que ven los usuariosrank registra la posición de cada sugerencia en la lista desplegable, empezando por 1 para la primera opción.
  • Elección del mercadolanguage y region cambian las sugerencias a otro mercado, por ejemplo es y MX para búsquedas en español de México.
  • Un enlace de búsqueda para cada fraseCada sugerencia incluye la URL de resultados de YouTube para esa frase, junto con la consulta inicial y el mercado con que se solicitó.

Parámetros de la YouTube Search Suggestions API

ParámetrosObligatorioDescripción
queryObligatorioComienzo de la búsqueda que se va a completar, de hasta 100 caracteres.
languageOpcionalCódigo de idioma de las sugerencias, como en, es o pt-BR. El valor predeterminado es en.
regionOpcionalCódigo de país de dos letras del mercado de búsqueda, como US o GB. El valor predeterminado es US.

Cómo usar la YouTube Search Suggestions API

Envíe el comienzo de una búsqueda y lea las sugerencias ordenadas.

  1. Envíe {"query": "iphone 17"} por POST a /v1/youtube/search-suggestions y agregue language y region para otro mercado.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea las sugerencias de results.items en orden de posición; continúe con results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"iphone 17"}'

# Each item is one suggestion: keyword, rank, language and region.

Casos de uso de la YouTube Search Suggestions API

  • Ampliación de una palabra clave inicial: Recopile las sugerencias para el nombre de un producto o tema y encuentre las frases más largas que los usuarios realmente buscan.
  • Títulos alineados con la búsqueda: Tome la redacción de las sugerencias mejor posicionadas para que el título de un video refleje cómo escribe la gente la consulta.
  • Comparación de la demanda entre mercados: Repita el mismo término inicial con distintos valores de language y region para ver cómo cambia la intención de un país a otro.

Consejos de expertos para la YouTube Search Suggestions API

  • Agregue una letra después del término inicial, como iphone 17 a, para obtener sugerencias que continúan con esa letra.
  • Mantenga los mismos valores de language y region cuando siga un término a lo largo del tiempo, porque cada mercado devuelve su propia lista.

Además de la YouTube Search Suggestions API, use estas APIs cuando necesite otro tipo de datos públicos de YouTube.

  • YouTube Channel Videos API — Recolecta videos públicos regulares desde URLs de canales, sin incluir Shorts ni transmisiones en vivo.
  • YouTube Comments API — Recolecta comentarios públicos, autores, interacción, videos de origen y contexto de la conversación.
  • YouTube Search API — Busca videos públicos regulares por palabra clave con filtros de metadatos compatibles.
  • YouTube Hashtag Search API — Encuentra videos públicos en los feeds de hashtags, con recolección de todo el contenido o solo de Shorts.
  • YouTube Channel Search API — Encuentra canales por palabra clave, con nombres, número de suscriptores, avatares y fragmentos de la descripción.
  • YouTube Shorts Search API — Busca Shorts por palabra clave, con enlaces, descripciones, número de vistas y miniaturas verticales.

Explorar otras plataformas

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

YouTube Search Suggestions API — FAQ

YouTube Search Suggestions API es una interfaz programática para obtener las sugerencias de autocompletado de la búsqueda de YouTube para una consulta parcial, en el idioma y la región elegidos. Devuelve cada frase sugerida con su posición.

Sí. Las sugerencias son las frases que muestra el cuadro de búsqueda de YouTube mientras se escribe, devueltas en el mismo orden.

Tantas como YouTube ofrezca para esa consulta, normalmente alrededor de una docena.

La Data API oficial no tiene ningún endpoint de autocompletado ni de sugerencias al escribir. Este endpoint devuelve las sugerencias que muestra el cuadro de búsqueda de YouTube, ordenadas para el idioma y la región que elija.

Cada solicitud cuesta una tarifa fija de 0.5 créditos, sin importar cuántas sugerencias devuelva.