Búsqueda por palabra clave de YouTube
Indique una palabra clave de YouTube y un recuento esperado para obtener videos públicos coincidentes, canales, visualizaciones y fechas de publicación.
Traducido · es-ESVer texto original
Descripción general
En YouTube, los espectadores deciden qué vídeo abrir por el título, el canal, las visualizaciones y lo reciente que es. Esta app convierte una palabra clave de búsqueda pública en una tabla de esos listados, para que el trabajo de marca, competencia y contenido parta de la misma vista que un espectador.
La palabra clave permanece junto a cada vídeo, de modo que las comparaciones posteriores siguen ligadas a la misma consulta. No sustituye comentarios, transcripciones ni la página completa de un canal.
Notas sobre los datos
Cada fila es un listado público de búsqueda por palabra clave en YouTube. Las filas se ordenan por Publicado el de más reciente a más antiguo, y el mismo ID del vídeo se conserva una sola vez. Visualizaciones y Texto de visualizaciones son las cifras de la tarjeta de búsqueda, no totales normalizados de un panel de canal. Duración mostrada es el reloj del reproductor y Duración ms la misma duración en milisegundos como texto. Publicado el y Recogido el no traen zona horaria. Publicación mostrada es la frase relativa de la tarjeta, por ejemplo 5 days ago. Estado del contenido es el texto de estado de origen. Imágenes de portada, Miniatura del canal, Insignias del vídeo y listas similares son texto JSON, no archivos de imagen. Palabra clave, ID de negocio y Elemento de origen repiten el contexto de búsqueda en las filas de la misma consulta.
No cubre comentarios, transcripciones, vídeos privados o no listados, ni la página de inicio completa de un canal. Banner del canal, Descripción del canal, URL del canal, Número de suscriptores y Resumen del vídeo suelen ir vacíos en los listados de búsqueda. Un Marcador sin datos distingue una palabra clave sin vídeos de las filas de vídeo normales.
Cómo se ve un resultado
Cada fila es un listado público de búsqueda de YouTube.
| Título del vídeo | Nombre del canal | URL del vídeo | Visualizaciones | Publicado el | Duración mostrada |
|---|---|---|---|---|---|
| Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison | Mariselle Hartwell | https://www.youtube.com/watch?v=EpGip-GW7g4 | 215 | 2026-09-04T18:42:58 | 4:23 |
| Opening my new OpenRun by Shokz Bone Conduction Sport Headphones | Type1Reframed | https://www.youtube.com/watch?v=Ccj5oDYwCEo | 2 | 2026-09-05T18:42:58 | 3:48 |
También están disponibles ID del vídeo, ID del canal, Tipo de contenido y Descripción del vídeo cuando el listado los muestra.
Casos de uso
- Para cuota de búsqueda, agrupe filas por Palabra clave y revise Título del vídeo, Nombre del canal y Visualizaciones para ver qué vídeos ocupan los primeros resultados.
- Para seguimiento de competidores, compare Nombre del canal, Canal verificado y Publicado el para ver quién publica en la misma consulta.
- Para planificación de contenido, lea Título del vídeo con Duración mostrada y Visualizaciones para separar explicaciones cortas de reseñas más largas.
- Para páginas de destino, conserve URL del vídeo y Imágenes de portada con Identificador del canal para reconstruir las tarjetas públicas que ven los espectadores.
Alcance y límites
Una palabra clave de búsqueda de YouTube por tarea, con un recuento esperado de 1 a 600; los resultados vuelven en lotes completos de 20 y pueden redondearse al alza; solo listados públicos de búsqueda por palabra clave, y la plataforma devuelve como máximo 600 vídeos.
- Adecuada para
- Cuando necesita listados públicos de búsqueda de YouTube para una palabra clave, con títulos, canales, visualizaciones y fechas de publicación.
- Cuando necesita comparar cómo aparecen los vídeos competidores para la misma palabra clave.
- No usar para
- Si necesita comentarios, transcripciones o la página de inicio completa de un canal, esta App solo devuelve listados de búsqueda por palabra clave.
- Si necesita datos privados, no listados o con inicio de sesión de YouTube, esta App solo cubre resultados de búsqueda públicos.
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el autor. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1Si no se devuelven vídeos, pruebe una palabra clave más amplia o habitual y confirme que la consulta se puede buscar en YouTube público.
- 2Conserve los registros completados tras un éxito parcial; vuelva a enviar la misma entrada después de una tarea fallida o caducada.
- 3Reintente más tarde tras un límite de velocidad, una indisponibilidad temporal o un tiempo de espera.
- 4Si falla la autenticación, verifique la API Key configurada para el entorno de ejecución.
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
| Campo | Nombre de negocio | Tipo | Obligatorio | Predeterminado | Enum / Restricciones | Ejemplo | Descripción |
|---|---|---|---|---|---|---|---|
| keyword | Palabra clave de búsqueda | string | Sí | — | — | Shokz | Marca, producto, tema o frase para buscar en YouTube. Cada tarea acepta una palabra clave de 1 a 512 caracteres. |
| crawl_count | Recuento de resultados esperado | integer | Sí | — | 1–600 | 1 | Número esperado de vídeos, de 1 a 600. Los resultados vuelven en lotes completos de 20, así que el recuento real puede redondearse al alza. Un lote parcial se factura igualmente como 20 vídeos. |
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
| Campo | Nombre de negocio | Tipo | Ejemplo | Descripción |
|---|---|---|---|---|
| account_badge_list | Insignias del canal | string | — | Insignias del canal, devueltas como texto JSON cuando existen. |
| account_display_id | Identificador del canal | string | @MariselleHartwell | Identificador público del canal, con @ cuando se muestra. |
| account_id | ID del canal | string | UCzIWiqlJ3CakJ7QpNaPHJNw | Identificador estable de YouTube del canal editor. |
| account_name | Nombre del canal | string | Mariselle Hartwell | Nombre visible del canal que publicó este listado. |
| article_type | Tipo de contenido | string | video | Tipo de listado devuelto, como video o short. |
| biz_id | ID de negocio | string | Shokz | Identificador de negocio del elemento de búsqueda que produjo este listado. |
| channel_banner_url | Banner del canal | string | — | URL del banner del canal cuando el listado de búsqueda lo incluye. |
| channel_description | Descripción del canal | string | — | Descripción pública del canal cuando el listado de búsqueda la incluye. |
| channel_description_links | Enlaces del canal | string | — | Enlaces de la descripción del canal, como texto JSON cuando existen. |
| channel_thumbnail_list | Miniatura del canal | string | [{"height": 68, "url": "https://yt3.ggpht.com/NosIQPZfiNCw_pXuwLWpNbx0T9jyIDMVJePbO6LVZGjKXz9ppAO49vmpqNyMGBDj96AufI9PMg=s68-c-k-c0x00ffffff-no-rj", "width": 68}] | Lista de avatares del canal, como texto JSON cuando existe. |
| channel_total_videos | Vídeos del canal | string | — | Recuento público de vídeos del canal cuando el listado lo incluye. |
| channel_url | URL del canal | string | — | URL pública del canal cuando el listado de búsqueda la incluye. |
| co_creator_info | Info de cocreador | string | — | Detalles del cocreador, como texto JSON cuando existen. |
| content_badge_list | Insignias del vídeo | string | ["New"] | Insignias de la tarjeta, como texto JSON cuando existen. |
| content_id | ID del vídeo | string | EpGip-GW7g4 | Identificador estable de YouTube de este vídeo. |
| content_rich_thumbnail_list | Miniatura enriquecida | string | [{"height": 180, "url": "https://i.ytimg.com/an_webp/EpGip-GW7g4/mqdefault_6s.webp?du=3000&sqp=CLDUhNUG&rs=AOn4CLA9KhjVt8CHIDcWbqhbSz4rCcFjXQ", "width": 320}] | Miniaturas enriquecidas o animadas, como texto JSON cuando existen. |
| content_status | Estado del contenido | string | RUNNING | Texto de estado de origen del listado en el momento de la recogida. |
| content_text | Descripción del vídeo | string | Shokz #OpenRunAir2 #BoneConduction In this comprehensive comparison, we dive deep into the differences between the new ... | Descripción breve o fragmento mostrado para este listado. |
| content_title | Título del vídeo | string | Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison | Título mostrado en la tarjeta pública de búsqueda de YouTube. |
| content_url | URL del vídeo | string | https://www.youtube.com/watch?v=EpGip-GW7g4 | URL pública de reproducción de este listado. |
| cover_image_list | Imágenes de portada | string | [{"height": 202, "url": "https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCOgCEMoBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLC3oubUMvaAVXixL45NhWFyGYHaWw", "width": 360}, {"height": 404, "url": "https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBcz_YqYgJfo5VIlQ0RXqnFnu4c1Q", "width": 720}] | Lista de imágenes de portada, como texto JSON cuando existe. |
| crawl_time | Recogido el | string | 2026-09-09T18:42:58 | Marca de tiempo de recogida, sin zona horaria. |
| is_collaboration | Colaboración | boolean | false | Si el listado está marcado como colaboración. Sí cuando es true. |
| is_verified | Canal verificado | boolean | false | Si el canal está verificado. Sí cuando es true. |
| is_verified_artist | Artista verificado | boolean | false | Si el canal es un artista verificado. Sí cuando es true. |
| keyword | Palabra clave | string | Shokz | Palabra clave de búsqueda que produjo este listado. |
| keyword_type | Tipo de palabra clave | string | keyword | Tipo de elemento de búsqueda, por ejemplo keyword. |
| list_order | Orden de lista | integer | 0 | Posición en la lista recogida, cuando se devuelve. |
| number_of_subscribers | Número de suscriptores | string | — | Texto público de suscriptores cuando el listado lo incluye. |
| publish_time | Publicado el | string | 2026-09-04T18:42:58 | Marca de tiempo de publicación, sin zona horaria. |
| raw_duration | Duración mostrada | string | 4:23 | Duración mostrada en la tarjeta, por ejemplo 4:23. |
| raw_publish_time | Publicación mostrada | string | 5 days ago | Frase relativa de publicación en la tarjeta, por ejemplo 5 days ago. |
| video_duration | Duración ms | string | 263000 | Duración del vídeo en milisegundos, devuelta como texto. |
| video_summary | Resumen del vídeo | string | — | Resumen más largo cuando el resultado de búsqueda lo incluye. |
| view_count | Visualizaciones | string | 215 | Visualizaciones mostradas en la tarjeta, como texto. |
| view_count_text | Texto de visualizaciones | string | 215 views | Frase de visualizaciones en la tarjeta, por ejemplo 215 views. |
| task_item | Elemento de origen | string | Shokz | Elemento de búsqueda enviado que produjo esta fila. |
| no_data | Marcador sin datos | boolean | false | Si esta fila marca un elemento de búsqueda sin vídeos. Sí cuando es true. |
Schema del registro
La salida se devuelve registro a registro. detail.output.idFieldHint
{
"type": "object",
"properties": {
"account_badge_list": {
"type": "string",
"title": "Insignias del canal",
"description": "Insignias del canal, devueltas como texto JSON cuando existen."
},
"account_display_id": {
"type": "string",
"title": "Identificador del canal",
"description": "Identificador público del canal, con @ cuando se muestra.",
"prefill": "@MariselleHartwell"
},
"account_id": {
"type": "string",
"title": "ID del canal",
"description": "Identificador estable de YouTube del canal editor.",
"prefill": "UCzIWiqlJ3CakJ7QpNaPHJNw"
},
"account_name": {
"type": "string",
"title": "Nombre del canal",
"description": "Nombre visible del canal que publicó este listado.",
"prefill": "Mariselle Hartwell"
},
"article_type": {
"type": "string",
"title": "Tipo de contenido",
"description": "Tipo de listado devuelto, como video o short.",
"prefill": "video"
},
"biz_id": {
"type": "string",
"title": "ID de negocio",
"description": "Identificador de negocio del elemento de búsqueda que produjo este listado.",
"prefill": "Shokz"
},
"channel_banner_url": {
"type": "string",
"title": "Banner del canal",
"description": "URL del banner del canal cuando el listado de búsqueda lo incluye."
},
"channel_description": {
"type": "string",
"title": "Descripción del canal",
"description": "Descripción pública del canal cuando el listado de búsqueda la incluye."
},
"channel_description_links": {
"type": "string",
"title": "Enlaces del canal",
"description": "Enlaces de la descripción del canal, como texto JSON cuando existen."
},
"channel_thumbnail_list": {
"type": "string",
"title": "Miniatura del canal",
"description": "Lista de avatares del canal, como texto JSON cuando existe.",
"prefill": "[{\"height\": 68, \"url\": \"https://yt3.ggpht.com/NosIQPZfiNCw_pXuwLWpNbx0T9jyIDMVJePbO6LVZGjKXz9ppAO49vmpqNyMGBDj96AufI9PMg=s68-c-k-c0x00ffffff-no-rj\", \"width\": 68}]"
},
"channel_total_videos": {
"type": "string",
"title": "Vídeos del canal",
"description": "Recuento público de vídeos del canal cuando el listado lo incluye."
},
"channel_url": {
"type": "string",
"title": "URL del canal",
"description": "URL pública del canal cuando el listado de búsqueda la incluye."
},
"co_creator_info": {
"type": "string",
"title": "Info de cocreador",
"description": "Detalles del cocreador, como texto JSON cuando existen."
},
"content_badge_list": {
"type": "string",
"title": "Insignias del vídeo",
"description": "Insignias de la tarjeta, como texto JSON cuando existen.",
"prefill": "[\"New\"]"
},
"content_id": {
"type": "string",
"title": "ID del vídeo",
"description": "Identificador estable de YouTube de este vídeo.",
"prefill": "EpGip-GW7g4"
},
"content_rich_thumbnail_list": {
"type": "string",
"title": "Miniatura enriquecida",
"description": "Miniaturas enriquecidas o animadas, como texto JSON cuando existen.",
"prefill": "[{\"height\": 180, \"url\": \"https://i.ytimg.com/an_webp/EpGip-GW7g4/mqdefault_6s.webp?du=3000&sqp=CLDUhNUG&rs=AOn4CLA9KhjVt8CHIDcWbqhbSz4rCcFjXQ\", \"width\": 320}]"
},
"content_status": {
"type": "string",
"title": "Estado del contenido",
"description": "Texto de estado de origen del listado en el momento de la recogida.",
"prefill": "RUNNING"
},
"content_text": {
"type": "string",
"title": "Descripción del vídeo",
"description": "Descripción breve o fragmento mostrado para este listado.",
"prefill": "Shokz #OpenRunAir2 #BoneConduction In this comprehensive comparison, we dive deep into the differences between the new ..."
},
"content_title": {
"type": "string",
"title": "Título del vídeo",
"description": "Título mostrado en la tarjeta pública de búsqueda de YouTube.",
"prefill": "Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison"
},
"content_url": {
"type": "string",
"title": "URL del vídeo",
"description": "URL pública de reproducción de este listado.",
"prefill": "https://www.youtube.com/watch?v=EpGip-GW7g4"
},
"cover_image_list": {
"type": "string",
"title": "Imágenes de portada",
"description": "Lista de imágenes de portada, como texto JSON cuando existe.",
"prefill": "[{\"height\": 202, \"url\": \"https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCOgCEMoBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLC3oubUMvaAVXixL45NhWFyGYHaWw\", \"width\": 360}, {\"height\": 404, \"url\": \"https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBcz_YqYgJfo5VIlQ0RXqnFnu4c1Q\", \"width\": 720}]"
},
"crawl_time": {
"type": "string",
"title": "Recogido el",
"description": "Marca de tiempo de recogida, sin zona horaria.",
"prefill": "2026-09-09T18:42:58"
},
"is_collaboration": {
"type": "boolean",
"title": "Colaboración",
"description": "Si el listado está marcado como colaboración. Sí cuando es true.",
"prefill": false
},
"is_verified": {
"type": "boolean",
"title": "Canal verificado",
"description": "Si el canal está verificado. Sí cuando es true.",
"prefill": false
},
"is_verified_artist": {
"type": "boolean",
"title": "Artista verificado",
"description": "Si el canal es un artista verificado. Sí cuando es true.",
"prefill": false
},
"keyword": {
"type": "string",
"title": "Palabra clave",
"description": "Palabra clave de búsqueda que produjo este listado.",
"prefill": "Shokz"
},
"keyword_type": {
"type": "string",
"title": "Tipo de palabra clave",
"description": "Tipo de elemento de búsqueda, por ejemplo keyword.",
"prefill": "keyword"
},
"list_order": {
"type": "integer",
"title": "Orden de lista",
"description": "Posición en la lista recogida, cuando se devuelve.",
"prefill": 0
},
"number_of_subscribers": {
"type": "string",
"title": "Número de suscriptores",
"description": "Texto público de suscriptores cuando el listado lo incluye."
},
"publish_time": {
"type": "string",
"title": "Publicado el",
"description": "Marca de tiempo de publicación, sin zona horaria.",
"prefill": "2026-09-04T18:42:58"
},
"raw_duration": {
"type": "string",
"title": "Duración mostrada",
"description": "Duración mostrada en la tarjeta, por ejemplo 4:23.",
"prefill": "4:23"
},
"raw_publish_time": {
"type": "string",
"title": "Publicación mostrada",
"description": "Frase relativa de publicación en la tarjeta, por ejemplo 5 days ago.",
"prefill": "5 days ago"
},
"video_duration": {
"type": "string",
"title": "Duración ms",
"description": "Duración del vídeo en milisegundos, devuelta como texto.",
"prefill": "263000"
},
"video_summary": {
"type": "string",
"title": "Resumen del vídeo",
"description": "Resumen más largo cuando el resultado de búsqueda lo incluye."
},
"view_count": {
"type": "string",
"title": "Visualizaciones",
"description": "Visualizaciones mostradas en la tarjeta, como texto.",
"prefill": "215"
},
"view_count_text": {
"type": "string",
"title": "Texto de visualizaciones",
"description": "Frase de visualizaciones en la tarjeta, por ejemplo 215 views.",
"prefill": "215 views"
},
"task_item": {
"type": "string",
"title": "Elemento de origen",
"description": "Elemento de búsqueda enviado que produjo esta fila.",
"prefill": "Shokz"
},
"no_data": {
"type": "boolean",
"title": "Marcador sin datos",
"description": "Si esta fila marca un elemento de búsqueda sin vídeos. Sí cuando es true.",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}Integración
Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino.
Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.
Configuración del cliente
Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.
{
"mcpServers": {
"hello_moto__youtube-keyword-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/youtube-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Deja que la IA lo configure por ti
¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)
detail.access.mcp.composeHint
Precios
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 20 registro; cualquier unidad parcial se redondea a 20 registro.
Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.
Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.
Ver créditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.