logo
languageESdown
menu

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ídeoNombre del canalURL del vídeoVisualizacionesPublicado elDuración mostrada
Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: ComparisonMariselle Hartwellhttps://www.youtube.com/watch?v=EpGip-GW7g42152026-09-04T18:42:584:23
Opening my new OpenRun by Shokz Bone Conduction Sport HeadphonesType1Reframedhttps://www.youtube.com/watch?v=Ccj5oDYwCEo22026-09-05T18:42:583: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.

  1. 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.
  2. 2Conserve los registros completados tras un éxito parcial; vuelva a enviar la misma entrada después de una tarea fallida o caducada.
  3. 3Reintente más tarde tras un límite de velocidad, una indisponibilidad temporal o un tiempo de espera.
  4. 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.

CampoNombre de negocioTipoObligatorioPredeterminadoEnum / RestriccionesEjemploDescripción
keywordPalabra clave de búsquedastringSí——ShokzMarca, producto, tema o frase para buscar en YouTube. Cada tarea acepta una palabra clave de 1 a 512 caracteres.
crawl_countRecuento de resultados esperadointegerSí—1–6001Nú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.

CampoNombre de negocioTipoEjemploDescripción
account_badge_listInsignias del canalstring—Insignias del canal, devueltas como texto JSON cuando existen.
account_display_idIdentificador del canalstring@MariselleHartwellIdentificador público del canal, con @ cuando se muestra.
account_idID del canalstringUCzIWiqlJ3CakJ7QpNaPHJNwIdentificador estable de YouTube del canal editor.
account_nameNombre del canalstringMariselle HartwellNombre visible del canal que publicó este listado.
article_typeTipo de contenidostringvideoTipo de listado devuelto, como video o short.
biz_idID de negociostringShokzIdentificador de negocio del elemento de búsqueda que produjo este listado.
channel_banner_urlBanner del canalstring—URL del banner del canal cuando el listado de búsqueda lo incluye.
channel_descriptionDescripción del canalstring—Descripción pública del canal cuando el listado de búsqueda la incluye.
channel_description_linksEnlaces del canalstring—Enlaces de la descripción del canal, como texto JSON cuando existen.
channel_thumbnail_listMiniatura del canalstring[{"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_videosVídeos del canalstring—Recuento público de vídeos del canal cuando el listado lo incluye.
channel_urlURL del canalstring—URL pública del canal cuando el listado de búsqueda la incluye.
co_creator_infoInfo de cocreadorstring—Detalles del cocreador, como texto JSON cuando existen.
content_badge_listInsignias del vídeostring["New"]Insignias de la tarjeta, como texto JSON cuando existen.
content_idID del vídeostringEpGip-GW7g4Identificador estable de YouTube de este vídeo.
content_rich_thumbnail_listMiniatura enriquecidastring[{"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_statusEstado del contenidostringRUNNINGTexto de estado de origen del listado en el momento de la recogida.
content_textDescripción del vídeostringShokz #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_titleTítulo del vídeostringShokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: ComparisonTítulo mostrado en la tarjeta pública de búsqueda de YouTube.
content_urlURL del vídeostringhttps://www.youtube.com/watch?v=EpGip-GW7g4URL pública de reproducción de este listado.
cover_image_listImágenes de portadastring[{"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_timeRecogido elstring2026-09-09T18:42:58Marca de tiempo de recogida, sin zona horaria.
is_collaborationColaboraciónbooleanfalseSi el listado está marcado como colaboración. Sí cuando es true.
is_verifiedCanal verificadobooleanfalseSi el canal está verificado. Sí cuando es true.
is_verified_artistArtista verificadobooleanfalseSi el canal es un artista verificado. Sí cuando es true.
keywordPalabra clavestringShokzPalabra clave de búsqueda que produjo este listado.
keyword_typeTipo de palabra clavestringkeywordTipo de elemento de búsqueda, por ejemplo keyword.
list_orderOrden de listainteger0Posición en la lista recogida, cuando se devuelve.
number_of_subscribersNúmero de suscriptoresstring—Texto público de suscriptores cuando el listado lo incluye.
publish_timePublicado elstring2026-09-04T18:42:58Marca de tiempo de publicación, sin zona horaria.
raw_durationDuración mostradastring4:23Duración mostrada en la tarjeta, por ejemplo 4:23.
raw_publish_timePublicación mostradastring5 days agoFrase relativa de publicación en la tarjeta, por ejemplo 5 days ago.
video_durationDuración msstring263000Duración del vídeo en milisegundos, devuelta como texto.
video_summaryResumen del vídeostring—Resumen más largo cuando el resultado de búsqueda lo incluye.
view_countVisualizacionesstring215Visualizaciones mostradas en la tarjeta, como texto.
view_count_textTexto de visualizacionesstring215 viewsFrase de visualizaciones en la tarjeta, por ejemplo 215 views.
task_itemElemento de origenstringShokzElemento de búsqueda enviado que produjo esta fila.
no_dataMarcador sin datosbooleanfalseSi 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

output.schema
{
  "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 config
{
  "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

20 registros devueltos

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.

0,003 US$/ 20 registro
Per task submitted

Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.

0,0001 US$/ ejecución

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éditos

Pruébalo ahora

Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.

Ejemplo
Los parámetros se validan contra input.schema antes del envío
Rellena primero los parámetros obligatorios
Desde 0,003 US$ / 20 registro