Endpoint REST API

GET /v1/sources

Zdroje návštěvnosti z aktuálního živého období s klasifikací a volitelnými podrobnostmi.

Požadavek

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

Tento specializovaný endpoint použijte, když potřebujete zjistit, odkud přišli aktuální čtenáři, a nepotřebujete kompletní data Realtime pro nejčtenější stránky.

Ověření

Vyžaduje klíč API v hlavičce Authorization: Bearer nm_YOUR_KEY.

Parametry dotazu

Název Typ Povinné Popis
site string povinné ID trackeru. Klíč API musí mít k tomuto trackeru přístup.

Příklad cURL

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

Příklad odpovědi

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

Pole odpovědi

Pole Typ Popis
site string ID trackeru použité pro požadavek.
updated_at string Časové razítko UTC označující okamžik vygenerování dat odpovědi.
total_visitors integer Aktivní uživatelé zahrnutí do rozdělení podle zdrojů.
sources[] array<object> Položky zdrojů seřazené podle počtu.
sources[].medium string Kategorie zdroje, například search, social, newsletter, (none) nebo (not set), pokud utm_source nemá utm_medium.
sources[].source string Normalizovaný název zdroje.
sources[].count integer Počet aktivních uživatelů z tohoto zdroje.
sources[].percent integer Zaokrouhlený podíl z celkového počtu návštěvníků v procentech.
sources[].children[] array<object> Volitelné podrobné položky, například názvy hostitelů ve vyhledávání nebo názvy kampaní.
sources[].children[].label string Popisek podrobné položky.
sources[].children[].count integer Počet v podrobné položce.

Aktuálnost a cachování

Odpovědi se pro každý tracker ukládají do mikrocache na 8 sekund. Odpověď obsahuje také X-NowMetrix-Microcache s hodnotou HIT nebo MISS.

Chyby

HTTP Kód Popis
400 site_required Chybí povinný parametr site.
401 missing_token Chybí hlavička Authorization.
401 invalid_token Token je neplatný nebo byl odvolán.
403 site_not_authorized Klíč API nemá k tomuto trackeru přístup.
429 rate_limit_exceeded Byl překročen limit požadavků.
503 redis_unavailable Backend pro Realtime je dočasně nedostupný. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}