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.

Izmēģināt API Playground

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."
  }
}