API Youtube - Método GET /search

Permite realitzar búsquedas en Youtube para obtener vídeos usando diferentes operadores para así acotar el contenido.

El contenido devuelto de cada vídeo hace referencia a los datos descriptivos del vídeo y sus estadísticas sin los comentarios del mismo.

Parámetros GET

Veamos la estructura de la consulta de ejemplo:

https://youtube.trawlingweb.com/search/?token={APIKEY}&q=messi&tsi=15350188800000&ts=1547510400000&size=50

Parámetros PATH

Parámetros QUERY

Respuesta de salida - RESPONSE

Una vez lanzada una petición al API, éste devolverá los datos estructurados en función del método de obtención:

Datos de búsqueda de vídeos

Datos de petición

Ejemplo de respuesta en formato json:

"json"
"response" : {
  "data" : [{
    "id" : "...",
    "url" : "...",
    "urlShort" : "...",
    "urlEmbed" : "...",
    "published" : "...",
    "channelId" : "...",
    "channelTitle" : "...",
    "description" : "...",
    "thumbnails" : {
      "default":{
          "url":"...",
          "width":"...",
          "height":".."
      },
      "medium":{
          "url":"...",
          "width":"...",
          "height":".."
      },
      "high":{
          "url":"...",
          "width":"...",
          "height":".."
      },
      "standard":{
          "url":"...",
          "width":"...",
          "height":".."
      },
      "maxres":{
          "url":"...",
          "width":"...",
          "height":".."
      }
    },
    "tags" : ["...","...","..."],
    "categoryId" : "...",
    "liveBroadcastContent" : "...",
    "viewCount" : "...",
    "likeCont" : "...",
    "dislikeCount" : "...",
    "favoriteCount" : "...",
    "commentCount" : "..."
  }],
  "requestLeft" : "...",
  "totalResults" : "...",
  "restResults" : "...",
  "next" : "..."
}

API YOUTUBE - Consultas básicas

El API permite las mismas consultas que se realizan al actual buscador de la web de Youtube. Los criterios en que se aplican al filtrar los vídeos son establedos por la propia Youtube.

Booleanas

Los paréntesis

Utilice paréntesis para encapsular declaraciones OR para que los motores de búsqueda ejecuten la consulta de forma correcta.

Por ejemplo: (Barcelona|Madrid|París)

Otros términos filtrables

Búsqueda de vídeos con términos juntos

Tortilla patata casera

Búsqueda de vídeos con términos en el título

allintitle:Walt Disney

Búsqueda de vídeos que contienen combinaciones de palabras

"U2 Melbourne 2006"

Búsqueda de vídeos en canal

Elvis Presley, channel

Búsqueda de vídeos peliculas

Charlie Chaplin, movie

Búsqueda de vídeos en 4k

Tokio, 4k

Búsqueda de vídeos en HD

Trailer de Star Trek, hd

Búsqueda de vídeos en SD

Moscú, sd

Búsqueda de vídeos en ED

Madagascar, 3d

Búsqueda de vídeos por duración inferior a 2 minutos

Simpsons, short

Búsqueda de vídeos por duración múnima de 20 minutos

Spiderman, long

Búsqueda de vídeos en directo

zoo, live

Búsqueda de vídeos por tiempo

noticias, today
noticias, this week
noticias, this month
noticias, this year

Búsqueda de vídeos en canales oficiales

The show must go on, partner

Búsqueda de vídeos en playlist

Queen, playlist

Búsqueda de vídeos usando el concepto booleano (NOT)

android -china

Búsqueda de vídeos usando el concepto booleano (AND)

Barcelona AND Paris

Búsqueda de vídeos usando el concepto booleano (OR)

Barcelona OR Paris

Búsqueda de vídeos convinado los anteriores

(Barcelona AND Paris) -messi ,4k , long

API YOUTUBE - Mejores prácticas

Con el fin de utilizar la API es necesario llamar a una URL de punto final con su token de acceso privado. Puede generar la URL de su llamada en nuestro Testeador visual de la API (que debe acceder a https://dashboard.trawlingweb.com/playground).

Integridad de los datos

Cada solicitud al API puede devolver un número máximo de elementos coincidentes con su consulta. Sin embargo, pueden haber muchos más resultados que coincidan con sus parámetros de filtro. Para consumir todos los datos ha de seguir realizando llamadas a la URL indicada en el parámetro next de las salida de cada solicitud.

Ejemplo de salida

requestLeft	9999999
totalResults	295404987
next	"http://youtube.trawlingweb.com/?token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&q=messi"
}

Paginación

Al realizar peticiones a los métodos SEARCH estos devuelven un máximo de 50 vídeos. Se habilita una url de next para continuar con la obtención de vídeos si estos superan dicha cantidad.