API REST

Integre los datos de NowMetrix en las herramientas que su equipo ya utiliza.

Empiece con una instantánea en tiempo real, cree un panel para la redacción o envíe resultados históricos a su flujo de trabajo de elaboración de informes. Elija aquí un endpoint y consulte su referencia técnica completa.

Conecte su aplicación

¿Es la primera vez que utiliza la API? Empiece con la guía de conexión completa. En ella se explica cómo crear y proteger una clave de API, verificarla con /api/me y realizar la misma solicitud autenticada desde los lenguajes de programación habituales.

Abrir la guía de conexión

Empiece con una URL base

Toda solicitud autenticada mediante una clave de API comienza con este host:

https://api.nowmetrix.com

Envíe su clave de API

Envíe una clave de API como token Bearer en la cabecera Authorization. Los administradores de la cuenta y los miembros del equipo con acceso a la API pueden crear y etiquetar hasta 10 claves activas en el panel de NowMetrix, en Ajustes -> API.

Authorization: Bearer nm_YOUR_KEY

Se requiere HTTPS. Todas las claves utilizan los permisos de su usuario de NowMetrix y comparten el límite de solicitudes de cada tracker.

Realice su primera solicitud

La forma más rápida de probar la configuración es obtener una instantánea en tiempo real. Así se confirma que la clave funciona y puede acceder al tracker.

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/realtime?site=TRACKER_ID"

Elija los datos que necesita

Método Ruta Descripción Referencia
GET /v1/realtime Instantánea actual en tiempo real: usuarios activos, páginas vistas, páginas principales, dispositivos, países, ciudades y fuentes. Ver endpoint
GET /v1/sources Fuentes de tráfico de la ventana actual en tiempo real, con clasificación y filas anidadas opcionales. Ver endpoint
GET /v1/overview Páginas vistas y visitas diarias de los últimos N registros históricos completos. Ver endpoint
GET /v1/recap Datos de Recap, métricas resumidas y páginas principales para periodos predefinidos o un intervalo de fechas personalizado. Ver endpoint
GET /v1/pulse Datos de hoy, comparación con ayer y curvas intradía de 15 minutos. Ver endpoint
GET /v1/proofreading Hasta 100 sugerencias de revisión de texto visibles en ese momento, procedentes de los artículos de un tracker revisados más recientemente. Ver endpoint
GET /v1/responsibilities Responsabilidades actuales del equipo para un tracker, incluido quién tiene asignada cada función visible. Ver endpoint
GET /api/me Contexto de la cuenta asociada a la clave de API: el tracker actual y todos los trackers a los que puede acceder el token. Ver endpoint

Mantenga las solicitudes rápidas y predecibles

La API pública permite 20 solicitudes por minuto y tracker. Varios usuarios o claves que consulten el mismo tracker comparten el mismo contador.

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1783612801
Retry-After: 42
Almacene en caché las respuestas de la API en su propio sistema siempre que sea posible. Como regla general, almacene brevemente los datos en tiempo real y durante varios minutos los datos históricos de resumen.

Cuando falla una solicitud

No debería tener que analizar un formato diferente para cada problema. Los errores de la API utilizan un cuerpo JSON uniforme con un código estable y legible por máquinas.

HTTP Código Descripción
400 site_required Falta el parámetro site obligatorio.
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. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}