GET /v1/sources | API REST NowMetrix

Requête

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

Utilisez ce point d’accès ciblé pour savoir d’où viennent les lecteurs en direct, sans avoir besoin de la réponse complète de l’endpoint realtime consacré aux pages principales.

Authentification

Une clé API est requise dans l’en-tête Authorization : Authorization: Bearer nm_YOUR_KEY.

Paramètres de requête

Nom	Type	Obligatoire	Description
`site`	`string`	obligatoire	Identifiant du tracker. La clé API doit autoriser l’accès à ce tracker.

Exemple cURL

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

Exemple de réponse

{
  "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
        }
      ]
    }
  ]
}

Champs de la réponse

Champ	Type	Description
`site`	`string`	Identifiant du tracker utilisé pour la requête.
`updated_at`	`string`	Horodatage UTC de génération de la réponse.
`total_visitors`	`integer`	Utilisateurs actifs représentés dans la répartition par source.
`sources[]`	`array<object>`	Lignes de sources triées par nombre.
`sources[].medium`	`string`	Catégorie de source, par exemple search, social, newsletter, (none) ou (not set) lorsque utm_source ne comporte pas de utm_medium.
`sources[].source`	`string`	Libellé normalisé de la source.
`sources[].count`	`integer`	Nombre d’utilisateurs actifs provenant de cette source.
`sources[].percent`	`integer`	Pourcentage arrondi du nombre total de visiteurs.
`sources[].children[]`	`array<object>`	Lignes de détail facultatives, comme les noms d’hôte des moteurs de recherche ou les noms de campagnes.
`sources[].children[].label`	`string`	Libellé de la ligne détaillée.
`sources[].children[].count`	`integer`	Nombre d’utilisateurs associés à la ligne détaillée.

Actualisation et mise en cache

Les réponses sont conservées dans un microcache par tracker pendant 8 secondes. La réponse contient également l’en-tête X-NowMetrix-Microcache, dont la valeur est HIT ou MISS.

Erreurs

HTTP	Code	Description
400	`site_required`	Le paramètre site obligatoire est manquant.
401	`missing_token`	L’en-tête Authorization est manquant.
401	`invalid_token`	Le token n’est pas valide ou a été révoqué.
403	`site_not_authorized`	La clé API n’autorise pas l’accès à ce tracker.
429	`rate_limit_exceeded`	La limite de requêtes a été dépassée.
503	`redis_unavailable`	Le service backend realtime est temporairement indisponible.

{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}