REST API galapunkts

GET /v1/sources

Datplūsmas avoti pašreizējā tiešsaistes periodā ar klasifikāciju un neobligātām pakārtotām rindām.

Pieprasījums

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

Izmantojiet šo specializēto galapunktu, ja vēlaties uzzināt, no kurienes nāk tiešsaistē esošie lasītāji un Jums nav nepieciešami pilni reāllaika populārāko lapu dati.

Autentifikācija

Nepieciešama API atslēga Authorization galvenē: Authorization: Bearer nm_YOUR_KEY.

Vaicājuma parametri

Nosaukums Tips Obligāts Apraksts
site string obligāts Tracker ID. API atslēgai ir jābūt piekļuvei šim tracker.

cURL piemērs

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

Atbildes piemērs

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

Atbildes lauki

Lauks Tips Apraksts
site string Pieprasījumā izmantotais Tracker ID.
updated_at string UTC laikspiedols, kas norāda, kad tika ģenerēta datu kopa.
total_visitors integer Aktīvie lietotāji, kas iekļauti avotu sadalījumā.
sources[] array<object> Avotu rindas, sakārtotas pēc skaita.
sources[].medium string Avota kategorija, piemēram, search, social, newsletter, (none) vai (not set), ja utm_source nav norādīts utm_medium.
sources[].source string Normalizēts avota apzīmējums.
sources[].count integer Aktīvo lietotāju skaits no šī avota.
sources[].percent integer Noapaļota procentuālā daļa no kopējā apmeklētāju skaita.
sources[].children[] array<object> Neobligātas detalizētas rindas, piemēram, meklēšanas resursdatoru nosaukumi vai kampaņu nosaukumi.
sources[].children[].label string Pakārtotās rindas apzīmējums.
sources[].children[].count integer Pakārtotās rindas skaits.

Datu aktualitāte un kešatmiņa

Katram tracker atbildes tiek mikrokešotas 8 sekundes. Atbildē ir iekļauta arī galvene X-NowMetrix-Microcache ar vērtību HIT vai MISS.

Kļūdas

HTTP Kods Apraksts
400 site_required Trūkst obligātā site parametra.
401 missing_token Trūkst Authorization galvenes.
401 invalid_token Tokens ir nederīgs vai atsaukts.
403 site_not_authorized API atslēgai nav piekļuves šim tracker.
429 rate_limit_exceeded Pārsniegts pieprasījumu biežuma ierobežojums.
503 redis_unavailable Reāllaika aizmugursistēma īslaicīgi nav pieejama. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}