Vistear

Videos

Curva de un video

Espectadores minuto a minuto de una transmisión, con su resumen.

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

Devuelve el resumen de la transmisión (pico, promedio, duración, estado) y su curva de espectadores y likes.

Es abierta mientras la transmisión está en vivo y hasta 48 horas después de terminar. Las más viejas piden clave o sesión Pro, y la respuesta pasa a ser privada.

Por defecto la curva se agrupa según la duración: 1 minuto por punto hasta 6 horas, 2 hasta 12, 5 hasta 24 y 10 minutos después; de una transmisión de más de 72 horas llegan las últimas 48. Con resolution, from y to elegís la resolución y un tramo de hasta 72 horas en cualquier momento de la transmisión, por ejemplo el minuto a minuto de un programa dentro de un canal 24/7. Esas consultas siempre piden clave o sesión Pro, devuelven hasta 3.000 puntos y descuentan 1 consulta.

Autorización

Abierto durante la transmisión y 48 horas después. Después, clave de API o sesión Pro.

Parámetros de ruta

  • idstringobligatorio

    Id del video: los 11 caracteres de YouTube, kick:<canal>:<stream> o twitch:<canal>:<stream>.

Parámetros de consulta

  • resolutionnumber

    Minutos por punto, de 1 a 60. Con from y to, por defecto 1.

  • fromstring

    Inicio del tramo, ISO 8601 con zona (por ejemplo 2026-09-26T20:00:00-03:00). Va junto con to.

  • tostring

    Fin del tramo, ISO 8601 con zona. Hasta 72 horas después de from.

Respuesta

200 · application/json

  • videoVideoSummary

    Resumen de la transmisión.

    Ver campos de video
    • videoIdstring

      Id del video.

    • channelIdstring

      Cuenta que transmitió.

    • channelTitlestring

      Nombre del canal.

    • titlestring

      Título de la transmisión.

    • startedAtstring | null

      Inicio, ISO 8601.

    • endedAtstring | null

      Fin, o null si sigue en vivo.

    • isLiveboolean

      Si está en vivo ahora.

    • peakViewersnumber | null

      Pico de espectadores.

    • peakTsstring | null

      Momento del pico.

    • avgViewersnumber | null

      Promedio de espectadores.

    • likesMaxnumber | null

      Likes al cierre (YouTube).

    • minutesTrackednumber

      Minutos con datos.

    • durationMinutesnumber | null

      Duración total.

  • seriesSeriesPayload

    La curva, con la misma forma que las series (una sola serie, kind video).

  • chat{ t: number, v: number }[]

    Mensajes de chat por minuto, por hora, cuando se capturó el chat.

Códigos de estado

  • 200Resumen y curva 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 transmisiones de hace más de 48 horas.
  • 403La clave pertenece a un plan sin API, o la cuenta está bloqueada. Solo para transmisiones de 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 transmisiones de hace más de 48 horas.
  • 404Video no encontrado.
  • 502La base de datos no respondió. Reintentá.