Endpoint de REST API

GET /v1/sources

Fuentes de tráfico de la ventana actual en directo, con clasificación y filas secundarias opcionales.

Solicitud

GET https://api.nowmetrix.com/v1/sources?site=TRACKER_ID

Utilice este endpoint específico cuando necesite saber de dónde proceden los lectores en directo y no necesite la respuesta completa de páginas principales en tiempo real.

Autenticación

Requiere una clave de API en la cabecera 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.

Ejemplo con cURL

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

Ejemplo de respuesta

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_visitors": 128,
  "sources": [
    {
      "medium": "search",
      "source": "Google Search",
      "count": 46,
      "percent": 36,
      "children": [
        {
          "label": "google.com",
          "count": 28
        },
        {
          "label": "google.ch",
          "count": 18
        }
      ]
    },
    {
      "medium": "social",
      "source": "social.example",
      "count": 24,
      "percent": 19,
      "children": []
    },
    {
      "medium": "newsletter",
      "source": "morning-briefing",
      "count": 17,
      "percent": 13,
      "children": [
        {
          "label": "daily-edition",
          "count": 11
        },
        {
          "label": "evening-edition",
          "count": 6
        }
      ]
    }
  ]
}

Campos de respuesta

Campo Tipo Descripción
site string ID del tracker utilizado para la solicitud.
updated_at string Marca de tiempo UTC correspondiente a la generación de la respuesta.
total_visitors integer Usuarios activos representados en el desglose por fuente.
sources[] array<object> Filas de fuentes ordenadas por número de usuarios.
sources[].medium string Categoría de la fuente, por ejemplo search, social, newsletter, (none) o (not set) cuando utm_source no tiene utm_medium.
sources[].source string Etiqueta normalizada de la fuente.
sources[].count integer Número de usuarios activos procedentes de esta fuente.
sources[].percent integer Porcentaje redondeado del total de visitantes.
sources[].children[] array<object> Filas de detalle opcionales, como nombres de host de búsqueda o nombres de campañas.
sources[].children[].label string Etiqueta de la fila secundaria.
sources[].children[].count integer Número de usuarios de la fila secundaria.

Actualización y caché

Las respuestas se almacenan en microcaché durante 8 segundos por tracker. La respuesta también incluye X-NowMetrix-Microcache con el valor HIT o MISS.

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 backend en tiempo real no está disponible temporalmente. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}