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
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.
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 PlaygroundAutenticació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."
}
}