Vistear

Métricas diarias

Métricas diarias

Un punto por día y por canal unificado: vistas, likes, suscriptores, horas en vivo, horas vistas y picos.

GEThttps://www.vistear.com/api/v1/profiles/daily
Requiere claveCache: private, no-store

Devuelve la misma forma que las series, con un punto por día de Buenos Aires: stepMs es un día, t0 es la medianoche del primer día y los valores viajan en viewers (likes queda vacío).

Las cuentas de un canal se combinan: se suman, salvo peak_day, que toma el máximo. Las vistas y los likes por día terminan ayer, porque salen de la diferencia entre dos capturas de medianoche.

Autorización

Clave de API (plan Datos) o sesión Pro del sitio.

Parámetros de consulta

  • channelsstringobligatorio

    Ids de canal separados por coma, hasta 25: el UC… de YouTube, kick:<id> o twitch:<id>. Se deduplican y ordenan. También se acepta c= o el parámetro repetido.

  • metricenumobligatorio

    views_day y likes_day: ganados por día (YouTube). subs_youtube: suscriptores. subs_kick: suscripciones pagas de Kick. hours_day: horas en vivo (un decimal). hours_watched_day: horas vistas, espectadores promedio × horas en vivo (un decimal). peak_day: pico diario de espectadores.

    views_daylikes_daysubs_youtubesubs_kickhours_dayhours_watched_daypeak_day

  • daysenumdefault: 30

    Cantidad de días hasta hoy (o hasta ayer, para views_day y likes_day).

    373090

  • fromstring (YYYY-MM-DD)

    Primer día de una ventana de calendario (hora de Buenos Aires). Va junto con to y reemplaza range/days.

  • tostring (YYYY-MM-DD)

    Último día de la ventana, inclusive. Hasta 90 días en total y nunca en el futuro.

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

    Cantidad de puntos de cada serie.

  • daysnumber

    Días cubiertos.

  • seriesSeries[]

    Una serie por canal unificado.

    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.

    • thumbstring | null

      Imagen del canal o del video.

    • viewers(number | null)[]

      El valor de la métrica, un punto por día. null: ese día no hay dato.

    • likes[]

      Siempre vacío en este endpoint.

Códigos de estado

  • 200Una serie diaria por canal.
  • 400Métrica o días inválidos, un canal desconocido, o una ventana sin días completos todavía.
  • 401Falta la clave, es inválida o fue revocada (o la sesión del sitio venció).
  • 403La clave pertenece a un plan sin API, o la cuenta está bloqueada.
  • 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.
  • 502La base de datos no respondió. Reintentá.