Vistear

Videos

Vistas de un video

Vistas y likes acumulados de un video de YouTube, un punto por día.

GEThttps://www.vistear.com/api/v1/videos/{id}/views
Clave según antigüedadCache: public, s-maxage=60 (abierto) · private, no-store (con clave)

Sale de la captura diaria de medianoche (hora de Buenos Aires): viewers trae las vistas acumuladas y likes, los likes acumulados.

Es abierta durante las primeras 48 horas desde la publicación. Después pide clave o sesión Pro.

Autorización

Abierto durante 48 horas desde la publicación. Después, clave de API o sesión Pro.

Parámetros de ruta

  • idstringobligatorio

    Id del video de YouTube (11 caracteres).

Respuesta

200 · application/json

  • asOfstring (ISO 8601)

    Instante de corte de los datos, en UTC.

  • t0number

    Inicio del primer punto, en milisegundos epoch (UTC).

  • stepMsnumber

    Paso entre puntos, en milisegundos. El punto i corresponde a t0 + i × stepMs.

  • nnumber

    Días con captura desde la publicación.

  • seriesSeries[]

    Una sola serie, kind video: viewers son las vistas acumuladas y likes los likes acumulados (vacío si no hay).

    Ver campos de series
    • idstring

      Id del canal (o del video), estable entre consultas.

    • labelstring

      Nombre para mostrar.

    • kind"channel" | "video" | "total"

      Qué representa la serie.

    • viewers(number | null)[]

      n valores alineados a la grilla. null: no había transmisión (o dato) en ese punto.

    • likes(number | null)[]

      n valores, o vacío cuando la métrica no aplica (Kick y Twitch no reportan likes).

Códigos de estado

  • 200Historia diaria del video.
  • 400Id de video inválido.
  • 401Falta la clave, es inválida o fue revocada (o la sesión del sitio venció). Solo para videos publicados hace más de 48 horas.
  • 403La clave pertenece a un plan sin API, o la cuenta está bloqueada. Solo para videos publicados hace más de 48 horas.
  • 429Cuota mensual agotada y sin paquetes (error quota), o más de 300 consultas en un minuto (error rate). Retry-After dice cuántos segundos esperar. Solo para videos publicados hace más de 48 horas.
  • 404Video no encontrado, o todavía sin capturas.
  • 502La base de datos no respondió. Reintentá.