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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Comienzo de la búsqueda que se va a completar, de hasta 100 caracteres. |
language | Opcional | Código de idioma de las sugerencias, como en, es o pt-BR. El valor predeterminado es en. |
region | Opcional | Có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.
- Envíe {"query": "iphone 17"} por POST a /v1/youtube/search-suggestions y agregue language y region para otro mercado.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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.
- YouTube Transcripts API
- YouTube Channels API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Email Finder API
- YouTube Trending Videos API