Endpoint de REST API

GET /v1/sources-history

Evolución del mix de tráfico: promedio de lectores simultáneos por categoría de fuente durante la última hora, las últimas 24 horas, hoy, ayer, los últimos 7 días o un intervalo de fechas personalizado.

Solicitud

Historial disponible desde el 16 de noviembre de 2026

El historial de fuentes se registra desde el 16 de noviembre de 2026 y se amplía cada día. El registro comenzó alrededor de las 16:00 UTC, por lo que el 16 de noviembre solo contiene datos de la tarde y su valor diario no es comparable con el de días completos. Si un intervalo se remonta a antes del 16 de noviembre de 2026, from se ajusta a esa fecha y la respuesta incluye un aviso; si el intervalo termina antes de esa fecha, no se devuelve ningún punto. Las horas anteriores nunca se indican como cero.

GET https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today

Utilice este endpoint para consultar cómo ha evolucionado el mix de tráfico, por ejemplo, cuándo empezó a llegar tráfico de Google Discover o si el tráfico de búsqueda orgánica es inferior al de ayer. Cada punto contiene el promedio de lectores simultáneos por categoría de fuente en ese momento. Los valores no representan visitas ni páginas vistas y no deben sumarse a lo largo del tiempo; para consultar totales, utilice /v1/recap o /v1/overview. Para consultar fuentes individuales en directo, como una red social concreta o un boletín, utilice /v1/sources.

Probar en API Playground

Autenticación

Se requiere una clave de API en la cabecera Authorization: Authorization: Bearer nm_YOUR_KEY.

Parámetros de consulta

Nombre Tipo Obligatorio Descripción
site string obligatorio ID del tracker. La clave de API debe tener acceso a este tracker.
range string opcional Intervalo de tiempo. Puede ser 1h (últimos 60 minutos, puntos cada 2 minutos), 24h (últimas 24 horas, puntos cada 10 minutos), today y yesterday (día natural en la zona horaria del tracker, puntos cada 10 minutos), 7d (hoy y los 6 días anteriores, puntos cada hora) o custom (requiere start y end). Valor predeterminado: today.
start string opcional Primer día natural de un intervalo personalizado, con el formato YYYY-MM-DD y según la zona horaria del tracker. Es obligatorio con range=custom y no se permite con otros intervalos. No puede ser una fecha futura.
end string opcional Último día natural de un intervalo personalizado, con el formato YYYY-MM-DD, ambos inclusive. Es obligatorio con range=custom. El intervalo puede abarcar como máximo 366 días; si la fecha final está en el futuro, se ajusta a la hora actual. La resolución depende del número de días con datos registrados: puntos cada 10 minutos para intervalos de hasta 2 días, cada hora para intervalos de hasta 31 días y diarios para intervalos más largos.

Ejemplo de cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today"

Ejemplo de respuesta

{
  "site": "TRACKER_ID",
  "range": "today",
  "start": null,
  "end": null,
  "timezone": "Europe/Zurich",
  "unit": "avg_concurrent_readers",
  "resolution_minutes": 10,
  "from": "2026-11-18T00:00:00+01:00",
  "to": "2026-11-18T09:24:00+01:00",
  "data_available_from": "2026-11-16",
  "notice": null,
  "updated_at": "2026-11-18T08:24:30+00:00",
  "stale": false,
  "categories": [
    "organic",
    "discover",
    "direct",
    "internal",
    "social",
    "referral",
    "email",
    "ai"
  ],
  "points": [
    {
      "t": "2026-11-18T09:00:00+01:00",
      "total": 412.6,
      "unattributed": 6.4,
      "values": {
        "organic": 96.2,
        "discover": 131.5,
        "direct": 88.1,
        "internal": 41.3,
        "social": 27.9,
        "referral": 12.6,
        "email": 7.2,
        "ai": 1.4
      }
    },
    {
      "t": "2026-11-18T09:10:00+01:00",
      "total": 428.3,
      "unattributed": 5.9,
      "values": {
        "organic": 98.7,
        "discover": 144,
        "direct": 86.4,
        "internal": 42.8,
        "social": 28.5,
        "referral": 12.1,
        "email": 8.6,
        "ai": 1.3
      }
    }
  ]
}

Campos de la respuesta

Campo Tipo Descripción
site string ID del tracker utilizado en la solicitud.
range string Intervalo de tiempo solicitado.
start string|null Primer día solicitado para range=custom; en los demás casos, null.
end string|null Último día solicitado para range=custom; en los demás casos, null.
timezone string Zona horaria del tracker utilizada para los días naturales y las marcas de tiempo; por ejemplo, Europe/Zurich.
unit string Siempre avg_concurrent_readers: promedio de lectores activos al mismo tiempo dentro de cada punto.
resolution_minutes integer Duración de cada punto en minutos: 2, 10, 60 o 1440 (un día natural).
from string Inicio del intervalo como marca de tiempo ISO 8601 con el desfase de la zona horaria del tracker. Si el intervalo solicitado empieza antes de data_available_from, se ajusta a esa fecha.
to string Fin del intervalo como marca de tiempo ISO 8601 con desfase. En los intervalos en curso, corresponde a la hora actual.
data_available_from string Primer día con historial de fuentes registrado: 2026-11-16. El registro comenzó alrededor de las 16:00 UTC de ese día, por lo que se trata de un día incompleto.
notice object|null Se establece si el intervalo se remonta a antes de data_available_from; en los demás casos, es null. La solicitud se procesa correctamente y devuelve HTTP 200.
notice.code string partial_history: el intervalo empieza antes, por lo que from se ha ajustado y no hay puntos para los días anteriores. no_history: el intervalo termina antes de que comenzara el registro de datos, por lo que points está vacío.
notice.message string Explicación breve en inglés para los registros o para mostrarla al usuario.
updated_at string Marca de tiempo UTC en que se calculó el historial.
stale boolean true si se trata del último resultado válido porque el servicio de historial no está disponible temporalmente.
categories[] array<string> Todas las categorías de fuentes, siempre en el mismo orden: organic, discover, direct, internal, social, referral, email, ai. La lista siempre está completa, aunque no haya habido lectores en alguna categoría.
points[] array<object> Puntos en orden cronológico. Se omiten las horas sin datos recopilados, por lo que puede haber intervalos sin puntos.
points[].t string Inicio del punto como marca de tiempo ISO 8601 con desfase. Cuando los relojes se atrasan al final del horario de verano, la hora repetida se agrupa en un solo punto.
points[].total number Promedio de lectores simultáneos de todas las fuentes, redondeado a una cifra decimal.
points[].unattributed number Lectores incluidos en total que no se pueden asignar a una categoría. Actualmente, este valor suele ser 0, por lo que la suma de las categorías coincide con total. Calcule siempre las proporciones dividiendo el valor de la categoría entre total, para que el resultado siga siendo correcto si hay lectores sin asignar.
points[].values object Promedio de lectores simultáneos por categoría, con las claves correspondientes a los nombres de categories. Las categorías sin lectores tienen el valor 0.

Actualización y caché

Las respuestas se almacenan en caché por tracker e intervalo: 60 segundos para 1h, 24h y today; 5 minutos para 7d; y 30 minutos para yesterday. Los intervalos personalizados se almacenan en caché según las fechas de inicio y fin: 30 minutos si el intervalo ya ha terminado; en caso contrario, 60 segundos para puntos cada 10 minutos y 5 minutos para puntos horarios o diarios. Si el servicio de historial no está disponible temporalmente, se devuelve el último resultado válido con stale: true y una cabecera Warning. La respuesta también incluye X-NowMetrix-Microcache con el valor HIT, MISS o STALE.

Errores

HTTP Código Descripción
400 site_required Falta el parámetro obligatorio site.
401 missing_token Falta la cabecera Authorization.
401 invalid_token El token no es válido o se ha revocado.
403 site_not_authorized La clave de API no tiene acceso a este tracker.
429 rate_limit_exceeded Se ha superado el límite de solicitudes.
503 redis_unavailable El servicio de datos en tiempo real no está disponible temporalmente.
400 invalid_range El parámetro range debe ser 1h, 24h, today, yesterday, 7d o custom.
400 invalid_date_range Falta start o end, o no es una fecha YYYY-MM-DD válida; start es posterior a end o está en el futuro; el intervalo supera los 366 días; o se han enviado start y end sin range=custom.
503 source_history_unavailable El historial de fuentes no está disponible temporalmente y no hay ningún resultado reciente en la caché. Vuelva a intentarlo cuando haya transcurrido el tiempo indicado en la cabecera Retry-After.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}