Vistear

Rankings

Ranking

Ranking de canales por audiencia en vivo, vistas ganadas o crecimiento de suscriptores.

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

kind=live ordena por audiencia en vivo: el pico, el promedio, las horas al aire o las horas vistas del período (metric). kind=views ordena por vistas ganadas en YouTube, y kind=subs por suscriptores ganados en YouTube.

hoursWatched son las horas vistas (espectadores promedio × horas al aire) y share la cuota: qué porcentaje de las horas vistas de todas las cuentas del período le corresponde a esa cuenta.

movement compara el puesto con el período anterior de la misma duración: positivo es que subió. Es el mismo ranking que muestra el sitio, por cuenta de cada plataforma.

Autorización

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

Parámetros de consulta

  • kindenumdefault: live

    Qué se rankea.

    liveviewssubs

  • periodenumdefault: today

    today es el día de Buenos Aires en curso (para views y subs, el último día completo).

    today7d30d

  • metricenumdefault: peak

    Solo para kind=live: pico horario, promedio mientras está en vivo, horas al aire u horas vistas.

    peakavghourshours_watched

  • limitintegerdefault: 50

    Filas, entre 1 y 100.

Respuesta

200 · application/json

  • kind | period | metricstring

    Lo que se pidió.

  • window{ from, to }

    Período cubierto (ISO en live; días de Buenos Aires en views y subs).

  • rowsobject[]

    Filas en orden.

    Ver campos de rows
    • rank | movementnumber | null

      Puesto y cambio contra el período anterior (null: nuevo).

    • channelId | title | handle | platformstring

      La cuenta.

    • peak | peakAt | avg | hoursLive | hoursWatched | share | daysLivenumber | string | null

      kind=live. share: cuota de las horas vistas del período, en porcentaje (dos decimales).

    • viewsGained | likesGained | videosPublishednumber

      kind=views.

    • subscribers | subsGained | growthPctnumber | null

      kind=subs.

Códigos de estado

  • 200El ranking.
  • 400kind, period, metric o limit inválidos.
  • 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á.