GET /v1/realtime | NowMetrix REST API

Αίτημα

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

Χρησιμοποιήστε αυτό το endpoint όταν ένας πίνακας ελέγχου, μια οθόνη της αίθουσας σύνταξης, μια ειδοποίηση ή μια ελαφριά ενσωμάτωση χρειάζεται την τρέχουσα κατάσταση σε πραγματικό χρόνο ενός tracker.

Δοκιμή στο API Playground

Έλεγχος ταυτότητας

Απαιτείται API key στην κεφαλίδα Authorization με τιμή Bearer nm_YOUR_KEY.

Παράμετροι ερωτήματος

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`site`	`string`	υποχρεωτικό	ID του tracker. Το API key πρέπει να έχει πρόσβαση σε αυτόν τον tracker.

Παράδειγμα cURL

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

Παράδειγμα απόκρισης

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_realtime": 128,
  "total_pageviews_today": 48215,
  "total_unique_visitors_today": 31890,
  "devices": {
    "mobile": 91,
    "desktop": 37
  },
  "top_pages": [
    {
      "url": "/news/global-market-update",
      "host": "example-media.test",
      "title": "Global market update: what changed today",
      "og_image": "https://thumbs.nowmetrix.com/thumbnails/example.jpg",
      "realtime_users": 34,
      "pageviews_today": 6240,
      "sources": [
        {
          "medium": "social",
          "source": "social.example",
          "count": 18,
          "percent": 53,
          "children": []
        },
        {
          "medium": "search",
          "source": "Google Search",
          "count": 9,
          "percent": 26,
          "children": [
            {
              "label": "google.com",
              "count": 9
            }
          ]
        }
      ]
    }
  ],
  "countries": [
    {
      "code": "CH",
      "name": "Switzerland",
      "count": 52
    },
    {
      "code": "DE",
      "name": "Germany",
      "count": 31
    }
  ],
  "cities": [
    {
      "name": "Zurich",
      "count": 21
    },
    {
      "name": "Berlin",
      "count": 13
    }
  ],
  "sources_top5": [
    {
      "medium": "(none)",
      "source": "(direct)",
      "count": 44,
      "percent": 34,
      "children": []
    }
  ],
  "pageviews_last60": [
    [
      1782476550,
      125
    ],
    [
      1782476610,
      142
    ],
    [
      1782476670,
      38
    ]
  ]
}

Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`site`	`string`	ID του tracker που χρησιμοποιήθηκε για το αίτημα.
`updated_at`	`string`	Χρονική σήμανση UTC για τη στιγμή δημιουργίας των δεδομένων.
`total_realtime`	`integer`	Αριθμός ενεργών χρηστών στο τρέχον χρονικό παράθυρο σε πραγματικό χρόνο.
`total_pageviews_today`	`integer`	Συνολικές προβολές σελίδας που καταγράφηκαν σήμερα για τον tracker.
`total_unique_visitors_today`	`integer`	Κατά προσέγγιση μοναδικοί επισκέπτες που καταγράφηκαν σήμερα.
`devices.mobile`	`integer`	Ενεργοί χρήστες που ταξινομήθηκαν ως χρήστες κινητών συσκευών.
`devices.desktop`	`integer`	Ενεργοί χρήστες που ταξινομήθηκαν ως χρήστες υπολογιστών.
`top_pages[]`	`array<object>`	Έως 50 σελίδες σε πραγματικό χρόνο, ταξινομημένες με βάση τον αριθμό χρηστών σε πραγματικό χρόνο.
`top_pages[].url`	`string`	Διαδρομή σελίδας.
`top_pages[].host`	`string`	Όνομα host που αναφέρεται για τη σελίδα.
`top_pages[].title`	`string`	Τίτλος σελίδας· αν δεν υπάρχει, χρησιμοποιείται ως εναλλακτική η διαδρομή.
`top_pages[].og_image`	`string`	URL μικρογραφίας για τη σελίδα.
`top_pages[].realtime_users`	`integer`	Ενεργοί χρήστες που βρίσκονται αυτήν τη στιγμή σε αυτήν τη σελίδα.
`top_pages[].pageviews_today`	`integer`	Οι σημερινές προβολές σελίδας για αυτήν τη σελίδα.
`top_pages[].sources[]`	`array<object>`	Ανάλυση των πηγών επισκεψιμότητας για αυτήν τη σελίδα, με την ίδια μορφή γραμμών όπως στο /v1/sources.
`countries[]`	`array<object>`	Κορυφαίες χώρες με κωδικό, όνομα στα αγγλικά και πλήθος.
`cities[]`	`array<object>`	Κορυφαίες πόλεις με όνομα και πλήθος.
`sources_top5[]`	`array<object>`	Οι πέντε κορυφαίες πηγές συνολικής επισκεψιμότητας για το χρονικό παράθυρο σε πραγματικό χρόνο.
`pageviews_last60`	`array<[integer, integer]>`	Έως 60 ζεύγη [χρονική σήμανση Unix σε δευτερόλεπτα, προβολές σελίδων ανά λεπτό], από το παλαιότερο. Περιλαμβάνει το τρέχον, ημιτελές λεπτό. Τα λεπτά που λείπουν παραλείπονται· μια μη διαθέσιμη σειρά είναι κενός πίνακας. Οι χρονικές σημάνσεις διατηρούν τα δευτερόλεπτα της ώρας δημιουργίας της απόκρισης, όπως στο Legacy API.

Επικαιρότητα και caching

Οι αποκρίσεις διατηρούνται σε microcache ανά tracker για 8 δευτερόλεπτα. Η απόκριση περιλαμβάνει επίσης την κεφαλίδα X-NowMetrix-Microcache με την τιμή HIT ή MISS.

Σφάλματα

HTTP	Κωδικός	Περιγραφή
400	`site_required`	Λείπει η απαιτούμενη παράμετρος site.
401	`missing_token`	Λείπει η κεφαλίδα Authorization.
401	`invalid_token`	Το token δεν είναι έγκυρο ή έχει ανακληθεί.
403	`site_not_authorized`	Το API key δεν έχει πρόσβαση σε αυτόν τον tracker.
429	`rate_limit_exceeded`	Έχει ξεπεραστεί το όριο ρυθμού αιτημάτων.
503	`redis_unavailable`	Το backend δεδομένων σε πραγματικό χρόνο δεν είναι προσωρινά διαθέσιμο.

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