Docs    YouTube    Primeros pasos

Guía para crear una búsqueda personalizada

Puede crear una consulta de búsqueda completamente personalizada utilizando el campo de entrada de búsqueda personalizada y los parámetros que se muestran a continuación.

Cómo dar formato a una búsqueda personalizada
Para cada parámetro que añada, empiece con un ampersand "&" y luego la clave del parámetro (ej: "order") luego un signo de igual "=" y luego un valor aceptado (ej: "date"). No añada ninguna codificación URL ya que el plugin codificará correctamente la consulta de búsqueda final.

Ejemplos
&q=Funny Cat Videos&order=viewCount
&channelId=UClwg08ECyHnm_RzY1wnZC1A&publishedAfter=2019-06-30T00:00:00Z&publishedBefore=2020-01-30T00:00:00Z
&q=Gooseberry Falls&videoDuration=short

Clave de parámetro Valores aceptados
relatedToVideoId string
En relatedToVideoId recupera una lista de vídeos relacionados con el vídeo que identifica el valor del parámetro. El valor del parámetro debe ser un ID de vídeo de YouTube.Nota: Si se establece el parámetro relatedToVideoId, los únicos otros parámetros admitidos son regionCode, relevanceLanguage, safeSearchy fields.
channelId string
En channelId indica que la respuesta de la API sólo debe contener recursos creados por el canal.
eventType string
En eventType restringe la búsqueda a los eventos de difusión.
Los valores aceptables son:

  • completed - Sólo se incluyen las emisiones finalizadas.
  • live - Sólo incluye las emisiones activas.
  • upcoming - Incluya sólo las próximas emisiones.
location string
En location junto con el parámetro locationRadius define un área geográfica circular y restringe la búsqueda a los vídeos que especifican, en sus metadatos, una ubicación geográfica dentro de esa área. El valor del parámetro es una cadena que especifica las coordenadas de latitud/longitud, por ejemplo (37.42307,-122.08427).

  • En location identifica el punto en el centro del área.
  • En locationRadius especifica la distancia máxima a la que la ubicación asociada a un vídeo puede estar de ese punto para que el vídeo siga estando incluido en los resultados de la búsqueda.

La API devuelve un error si su solicitud especifica un valor para el parámetro location pero no especifica también un valor para el parámetro locationRadius parámetro.
locationRadius string
En locationRadius junto con el parámetro location El valor del parámetro debe ser un número en coma flotante seguido de una unidad de medida. Las unidades de medida válidas son m, km, fty mi. Por ejemplo, los valores válidos de los parámetros son 1500m, 5km, 10000fty 0.75mi. La API no admite locationRadius valores de los parámetros superiores a 1000 kilómetros.Nota: Véase la definición del location para más información.
order string
En order especifica el método que se utilizará para ordenar los recursos en la respuesta de la API. El valor por defecto es relevanceLos valores aceptables son:

  • date - Los recursos se clasifican en orden cronológico inverso según la fecha de creación.
  • rating - Los recursos se ordenan de mayor a menor puntuación.
  • relevance - Los recursos se ordenan en función de su relevancia para la consulta de búsqueda. Este es el valor por defecto para este parámetro.
  • title - Los recursos están ordenados alfabéticamente por título.
  • viewCount - Los recursos se ordenan de mayor a menor número de visualizaciones. Para las emisiones en directo, los vídeos se ordenan por número de espectadores simultáneos mientras duran las emisiones.
publishedAfter datetime
En publishedAfter indica que la respuesta de la API sólo debe contener recursos creados a partir de la hora especificada. El valor es un valor fecha-hora con formato RFC 3339 (1970-01-01T00:00:00Z).
publishedBefore datetime
En publishedBefore indica que la respuesta de la API sólo debe contener recursos creados antes o en el momento especificado. El valor es un valor fecha-hora con formato RFC 3339 (1970-01-01T00:00:00Z).
q string
En q especifica el término de la consulta que se va a buscar.Su petición también puede utilizar el parámetro booleano NOT (-) y OR (|) para excluir vídeos o encontrar vídeos asociados a uno de varios términos de búsqueda. Por ejemplo, para buscar vídeos que coincidan con "navegación" o "vela", defina los operadores q valor del parámetro a boating|sailing. Del mismo modo, para buscar vídeos que coincidan con "navegación" o "vela" pero no con "pesca", establezca la opción q valor del parámetro a boating|sailing -fishing.
regionCode string
En regionCode indica a la API que devuelva resultados de búsqueda de vídeos que puedan verse en el país especificado. El valor del parámetro es un ISO 3166-1 alfa-2 código de país.
relevanceLanguage string
En relevanceLanguage indica a la API que devuelva los resultados de búsqueda más relevantes para el idioma especificado. El valor del parámetro suele ser un Código lingüístico de dos letras ISO 639-1. Sin embargo, debe utilizar los valores zh-Hans para el chino simplificado y zh-Hant para chino tradicional. Tenga en cuenta que se mostrarán resultados en otros idiomas si son muy pertinentes para el término buscado.
safeSearch string
En safeSearch indica si los resultados de la búsqueda deben incluir contenido restringido además de contenido estándar:

  • moderate - YouTube filtrará algunos contenidos de los resultados de búsqueda y, como mínimo, filtrará los contenidos restringidos en tu localidad. En función de su contenido, los resultados de búsqueda podrían ser eliminados de los resultados de búsqueda o degradados en los resultados de búsqueda. Este es el valor por defecto del parámetro.
  • none - YouTube no filtrará el conjunto de resultados de la búsqueda.
  • strict - YouTube intentará excluir todos los contenidos restringidos del conjunto de resultados de búsqueda. En función de su contenido, los resultados de búsqueda podrían ser eliminados de los resultados de búsqueda o degradados en los resultados de búsqueda.
topicId string
En topicId indica que la respuesta de la API sólo debe contener recursos asociados al tema especificado. El valor identifica un ID de tema de Freebase.Importante: Debido a la desaparición de Freebase y de la API de Freebase, el archivo topicId empezó a funcionar de forma diferente a partir del 27 de febrero de 2017. En ese momento, YouTube comenzó a admitir un pequeño conjunto de ID de temas curados, y solo puedes utilizar ese conjunto más pequeño de ID como valores para este parámetro.

Temas
Temas musicales
/m/04rlf Música (tema principal)
/m/02mscn Música cristiana
/m/0ggq0m Música clásica
/m/01lyv País
/m/02lkt Música electrónica
/m/0glt670 Música hip hop
/m/05rwpb Música independiente
/m/03_d0 Jazz
/m/028sqc Música de Asia
/m/0g293 Música de América Latina
/m/064t9 Música pop
/m/06cqb Reggae
/m/06j6l Ritmo y blues
/m/06by7 Música rock
/m/0gywn Música soul
Temas de juego
/m/0bzvm2 Juegos (tema principal)
/m/025zzc Juego de acción
/m/02ntfj Juego de acción y aventura
/m/0b1vjn Juego casual
/m/02hygl Videojuego musical
/m/04q1x3q Videojuego de puzzle
/m/01sjng Videojuego de carreras
/m/0403l3g Videojuego de rol
/m/021bp2 Videojuego de simulación
/m/022dc6 Juego de deportes
/m/03hf_rm Videojuego de estrategia
Temas deportivos
/m/06ntj Deportes (tema principal)
/m/0jm_ Fútbol americano
/m/018jz Béisbol
/m/018w8 Baloncesto
/m/01cgz Boxeo
/m/09xp_ Cricket
/m/02vx4 Fútbol
/m/037hz Golf
/m/03tmr Hockey sobre hielo
/m/01h7lh Artes marciales mixtas
/m/0410tth Motorsport
/m/07bs0 Tenis
/m/07_53 Voleibol
Temas de entretenimiento
/m/02jjt Entretenimiento (tema principal)
/m/09kqc Humor
/m/02vxn Películas
/m/05qjc Artes escénicas
/m/066wd Lucha libre profesional
/m/0f2f9 Programas de televisión
Temas de estilo de vida
/m/019_rr Estilo de vida (tema principal)
/m/032tl Moda
/m/027x7n Fitness
/m/02wbm Alimentación
/m/03glg Hobby
/m/068hy Mascotas
/m/041xxh Atractivo físico [Belleza]
/m/07c1v Tecnología
/m/07bxq Turismo
/m/07yv9 Vehículos
Temas de sociedad
/m/098wr Sociedad (tema principal)
/m/09s1f Empresas
/m/0kt51 Salud
/m/01h6rj Militar
/m/05qt0 Política
/m/06bvp Religión
Otros temas
/m/01k8wb Conocimientos

 
videoCaption string
En videoCaption indica si la API debe filtrar los resultados de la búsqueda de vídeos en función de si tienen subtítulos:

  • any - No filtre los resultados en función de la disponibilidad de subtítulos.
  • closedCaption - Incluya sólo vídeos con subtítulos.
  • none - Incluya sólo vídeos que no tengan subtítulos.
videoCategoryId string
En videoCategoryId filtra los resultados de la búsqueda de vídeos en función de su categoría.
videoDefinition string
En videoDefinition le permite restringir una búsqueda para que sólo incluya vídeos de alta definición (HD) o de definición estándar (SD). Los vídeos HD pueden reproducirse al menos en 720p, aunque también pueden estar disponibles resoluciones superiores, como 1080p. Los valores aceptables son:

  • any - Devuelve todos los vídeos, independientemente de su resolución.
  • high - Sólo recupera vídeos HD.
  • standard - Sólo recupera vídeos en definición estándar.
videoDimension string
En videoDimension le permite restringir una búsqueda para recuperar sólo vídeos 2D o 3D. Los valores aceptables son:

  • 2d - Restringir los resultados de búsqueda para excluir los vídeos 3D.
  • 3d - Restringir los resultados de búsqueda para que sólo incluyan vídeos en 3D.
  • any - Incluir vídeos 3D y no 3D en los resultados devueltos. Este es el valor por defecto.
videoDuration string
En videoDuration filtra los resultados de la búsqueda de vídeos en función de su duración:

  • any - No filtrar los resultados de la búsqueda de vídeos en función de su duración. Este es el valor por defecto.
  • long - Incluya sólo vídeos de más de 20 minutos.
  • medium - Incluya sólo vídeos de entre 4 y 20 minutos de duración (ambos inclusive).
  • short - Incluya sólo vídeos de menos de cuatro minutos de duración.
videoEmbeddable string
En videoEmbeddable permite restringir la búsqueda a los vídeos que pueden incrustarse en una página web:

  • any - Devuelve todos los vídeos, incrustables o no.
  • true - Recuperar sólo vídeos incrustables.
videoLicense string
En videoLicense filtra los resultados de búsqueda para que sólo incluyan vídeos con una licencia determinada. YouTube permite a quienes suben vídeos elegir entre adjuntar la licencia Creative Commons o la licencia estándar de YouTube a cada uno de sus vídeos:

  • any - Devuelve todos los vídeos, independientemente de la licencia que tengan, que coincidan con los parámetros de la consulta.
  • creativeCommon - Sólo devuelve vídeos que tengan una licencia Creative Commons. Los usuarios pueden reutilizar vídeos con esta licencia en otros vídeos que creen. Más información.
  • youtube - Sólo devuelve vídeos que tengan la licencia estándar de YouTube.
videoSyndicated string
En videoSyndicated permite restringir la búsqueda a los vídeos que pueden reproducirse fuera de youtube.com:

  • any - Devuelve todos los vídeos, sindicados o no.
  • true - Recuperar sólo vídeos sindicados.
videoType string
En videoType permite restringir la búsqueda a un tipo concreto de vídeos:

  • any - Devolver todos los vídeos.
  • episode - Sólo recupera episodios de programas.
  • movie - Sólo recuperar películas.
soporte

¿No ha encontrado la respuesta en los documentos?

Contacto

¿Le ha resultado útil este artículo?

Categorías