Endpoint του REST API

GET /v1/sources-history

Μείγμα επισκεψιμότητας με την πάροδο του χρόνου: μέσος αριθμός ταυτόχρονων αναγνωστών ανά κατηγορία πηγής για την τελευταία ώρα, τις τελευταίες 24 ώρες, σήμερα, χθες, τις τελευταίες 7 ημέρες ή για ένα προσαρμοσμένο χρονικό διάστημα.

Αίτημα

Διαθέσιμο ιστορικό από τις 16 Νοεμβρίου 2026

Το ιστορικό πηγών καταγράφεται από τις 16 Νοεμβρίου 2026 και εμπλουτίζεται καθημερινά. Η καταγραφή ξεκίνησε περίπου στις 16:00 UTC, επομένως για τις 16 Νοεμβρίου υπάρχουν μόνο τα απογευματινά δεδομένα και η ημερήσια τιμή δεν είναι συγκρίσιμη με τις τιμές πλήρων ημερών. Αν ένα χρονικό διάστημα εκτείνεται πριν από τις 16 Νοεμβρίου 2026, το from μετακινείται σε αυτή την ημερομηνία και η απόκριση περιλαμβάνει σχετική ειδοποίηση. Αν το χρονικό διάστημα λήγει πριν από αυτή την ημερομηνία, δεν επιστρέφονται σημεία. Οι παλαιότερες χρονικές περίοδοι δεν αναφέρονται ποτέ ως μηδενικές.

GET https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today

Χρησιμοποιήστε αυτό το endpoint για να δείτε πώς εξελίχθηκε το μείγμα επισκεψιμότητας με την πάροδο του χρόνου, για παράδειγμα πότε άρχισε η επισκεψιμότητα από το Google Discover ή αν η οργανική αναζήτηση είναι πιο περιορισμένη σε σχέση με χθες. Κάθε σημείο περιλαμβάνει τον μέσο αριθμό ταυτόχρονων αναγνωστών ανά κατηγορία πηγής για το αντίστοιχο χρονικό διάστημα. Οι τιμές δεν αντιστοιχούν σε επισκέψεις ή προβολές σελίδας και δεν πρέπει να αθροίζονται με την πάροδο του χρόνου. Για συνολικά μεγέθη, χρησιμοποιήστε τα /v1/recap ή /v1/overview. Για μεμονωμένες πηγές σε πραγματικό χρόνο, όπως ένα συγκεκριμένο μέσο κοινωνικής δικτύωσης ή ένα ενημερωτικό δελτίο, χρησιμοποιήστε το /v1/sources.

Δοκιμή στο API Playground

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

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

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

Όνομα Τύπος Υποχρεωτικό Περιγραφή
site string υποχρεωτικό Αναγνωριστικό tracker. Το κλειδί API πρέπει να έχει πρόσβαση σε αυτόν τον tracker.
range string προαιρετικό Χρονικό διάστημα. Μπορείτε να επιλέξετε ένα από τα 1h (τελευταία 60 λεπτά, σημεία ανά 2 λεπτά), 24h (κυλιόμενο 24ωρο, σημεία ανά 10 λεπτά), today και yesterday (ημερολογιακή ημέρα στη ζώνη ώρας του tracker, σημεία ανά 10 λεπτά), 7d (σήμερα και οι προηγούμενες 6 ημέρες, ωριαία σημεία) ή custom (απαιτεί start και end). Προεπιλογή: today.
start string προαιρετικό Πρώτη ημερολογιακή ημέρα ενός προσαρμοσμένου χρονικού διαστήματος, στη μορφή YYYY-MM-DD και στη ζώνη ώρας του tracker. Απαιτείται όταν το range=custom και δεν επιτρέπεται με άλλα χρονικά διαστήματα. Δεν μπορεί να είναι μελλοντική ημερομηνία.
end string προαιρετικό Τελευταία ημερολογιακή ημέρα ενός προσαρμοσμένου χρονικού διαστήματος, στη μορφή YYYY-MM-DD, συμπεριλαμβανομένης. Απαιτείται όταν το range=custom. Το χρονικό διάστημα μπορεί να καλύπτει έως 366 ημέρες. Αν η ημερομηνία λήξης είναι μελλοντική, περικόπτεται στην τρέχουσα ώρα. Η ανάλυση εξαρτάται από τις ημέρες για τις οποίες υπάρχουν καταγεγραμμένα δεδομένα: έως 2 ημέρες, σημεία ανά 10 λεπτά· έως 31 ημέρες, ωριαία σημεία· για μεγαλύτερα διαστήματα, ημερήσια σημεία.

Παράδειγμα cURL

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

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

{
  "site": "TRACKER_ID",
  "range": "today",
  "start": null,
  "end": null,
  "timezone": "Europe/Zurich",
  "unit": "avg_concurrent_readers",
  "resolution_minutes": 10,
  "from": "2026-11-18T00:00:00+01:00",
  "to": "2026-11-18T09:24:00+01:00",
  "data_available_from": "2026-11-16",
  "notice": null,
  "updated_at": "2026-11-18T08:24:30+00:00",
  "stale": false,
  "categories": [
    "organic",
    "discover",
    "direct",
    "internal",
    "social",
    "referral",
    "email",
    "ai"
  ],
  "points": [
    {
      "t": "2026-11-18T09:00:00+01:00",
      "total": 412.6,
      "unattributed": 6.4,
      "values": {
        "organic": 96.2,
        "discover": 131.5,
        "direct": 88.1,
        "internal": 41.3,
        "social": 27.9,
        "referral": 12.6,
        "email": 7.2,
        "ai": 1.4
      }
    },
    {
      "t": "2026-11-18T09:10:00+01:00",
      "total": 428.3,
      "unattributed": 5.9,
      "values": {
        "organic": 98.7,
        "discover": 144,
        "direct": 86.4,
        "internal": 42.8,
        "social": 28.5,
        "referral": 12.1,
        "email": 8.6,
        "ai": 1.3
      }
    }
  ]
}

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

Πεδίο Τύπος Περιγραφή
site string Το αναγνωριστικό tracker που χρησιμοποιήθηκε στο αίτημα.
range string Το ζητούμενο χρονικό διάστημα.
start string|null Η ζητούμενη πρώτη ημέρα όταν το range=custom, διαφορετικά null.
end string|null Η ζητούμενη τελευταία ημέρα όταν το range=custom, διαφορετικά null.
timezone string Η ζώνη ώρας του tracker που χρησιμοποιείται για τις ημερολογιακές ημέρες και τις χρονικές σημάνσεις, για παράδειγμα Europe/Zurich.
unit string Πάντα avg_concurrent_readers: ο μέσος αριθμός αναγνωστών που ήταν ενεργοί ταυτόχρονα σε κάθε σημείο.
resolution_minutes integer Η διάρκεια κάθε σημείου σε λεπτά: 2, 10, 60 ή 1440 (μία ημερολογιακή ημέρα).
from string Η αρχή του χρονικού διαστήματος ως χρονική σήμανση ISO 8601 με τη μετατόπιση της ζώνης ώρας του tracker. Αν το ζητούμενο διάστημα αρχίζει πριν από το data_available_from, η τιμή μετακινείται σε αυτή την ημερομηνία.
to string Το τέλος του χρονικού διαστήματος ως χρονική σήμανση ISO 8601 με μετατόπιση. Για χρονικά διαστήματα που βρίσκονται σε εξέλιξη, είναι η τρέχουσα ώρα.
data_available_from string Η πρώτη ημέρα για την οποία υπάρχει καταγεγραμμένο ιστορικό πηγών: 2026-11-16. Η καταγραφή ξεκίνησε περίπου στις 16:00 UTC εκείνη την ημέρα, επομένως πρόκειται για ελλιπή ημέρα.
notice object|null Ορίζεται αν το χρονικό διάστημα εκτείνεται πριν από το data_available_from, διαφορετικά είναι null. Το αίτημα ολοκληρώνεται κανονικά με HTTP 200.
notice.code string partial_history: το χρονικό διάστημα αρχίζει νωρίτερα, επομένως το from μετακινήθηκε και δεν υπάρχουν σημεία για τις προηγούμενες ημέρες. no_history: το χρονικό διάστημα λήγει πριν αρχίσει η καταγραφή δεδομένων, επομένως το points είναι κενό.
notice.message string Σύντομη επεξήγηση στα αγγλικά για καταγραφή σε αρχεία καταγραφής ή εμφάνιση.
updated_at string Χρονική σήμανση UTC που δηλώνει πότε υπολογίστηκε το ιστορικό.
stale boolean true αν πρόκειται για το τελευταίο έγκυρο αποτέλεσμα, επειδή το backend ιστορικού δεν είναι προσωρινά διαθέσιμο.
categories[] array<string> Όλες οι κατηγορίες πηγών, με σταθερή σειρά: organic, discover, direct, internal, social, referral, email, ai. Η λίστα είναι πάντα πλήρης, ακόμη κι αν δεν υπήρχαν αναγνώστες σε κάποια κατηγορία.
points[] array<object> Τα σημεία σε χρονολογική σειρά. Οι χρονικές περίοδοι για τις οποίες δεν συλλέχθηκαν δεδομένα παραλείπονται, επομένως ενδέχεται να υπάρχουν κενά.
points[].t string Η αρχή του σημείου ως χρονική σήμανση ISO 8601 με μετατόπιση. Όταν τα ρολόγια γυρίζουν πίσω στο τέλος της θερινής ώρας, η επαναλαμβανόμενη ώρα συνδυάζεται σε ένα σημείο.
points[].total number Ο μέσος αριθμός ταυτόχρονων αναγνωστών από όλες τις πηγές, στρογγυλοποιημένος στο ένα δεκαδικό ψηφίο.
points[].unattributed number Αναγνώστες που περιλαμβάνονται στο total και δεν μπορούν να αντιστοιχιστούν σε κατηγορία. Προς το παρόν η τιμή είναι συνήθως 0, επομένως οι κατηγορίες αθροίζονται στο total. Υπολογίζετε πάντα τα ποσοστά διαιρώντας την τιμή της κατηγορίας με το total, ώστε το αποτέλεσμα να παραμένει σωστό αν υπάρχουν αναγνώστες χωρίς αντιστοιχισμένη κατηγορία.
points[].values object Ο μέσος αριθμός ταυτόχρονων αναγνωστών ανά κατηγορία, με κλειδιά τα ονόματα που περιλαμβάνονται στο categories. Για τις κατηγορίες χωρίς αναγνώστες, η τιμή είναι 0.

Ενημέρωση δεδομένων και προσωρινή αποθήκευση

Οι αποκρίσεις αποθηκεύονται προσωρινά ανά tracker και χρονικό διάστημα: για 60 δευτερόλεπτα για τα 1h, 24h και today, για 5 λεπτά για το 7d και για 30 λεπτά για το yesterday. Τα προσαρμοσμένα χρονικά διαστήματα αποθηκεύονται προσωρινά ανά ημερομηνία έναρξης και λήξης: για 30 λεπτά αν το διάστημα έχει λήξει, διαφορετικά για 60 δευτερόλεπτα με σημεία ανά 10 λεπτά και για 5 λεπτά με ωριαία ή ημερήσια σημεία. Αν το backend ιστορικού δεν είναι προσωρινά διαθέσιμο, επιστρέφεται το τελευταίο έγκυρο αποτέλεσμα με stale: true και κεφαλίδα Warning. Η απόκριση περιλαμβάνει επίσης την κεφαλίδα X-NowMetrix-Microcache με τιμή HIT, MISS ή STALE.

Σφάλματα

HTTP Κωδικός Περιγραφή
400 site_required Λείπει η απαιτούμενη παράμετρος site.
401 missing_token Λείπει η κεφαλίδα Authorization.
401 invalid_token Το token δεν είναι έγκυρο ή έχει ανακληθεί.
403 site_not_authorized Το κλειδί API δεν έχει πρόσβαση σε αυτόν τον tracker.
429 rate_limit_exceeded Έχει ξεπεραστεί το όριο αιτημάτων.
503 redis_unavailable Το backend πραγματικού χρόνου δεν είναι προσωρινά διαθέσιμο.
400 invalid_range Η παράμετρος range πρέπει να είναι 1h, 24h, today, yesterday, 7d ή custom.
400 invalid_date_range Το start ή το end λείπει ή δεν είναι έγκυρη ημερομηνία YYYY-MM-DD, το start είναι μεταγενέστερο από το end ή βρίσκεται στο μέλλον, το χρονικό διάστημα υπερβαίνει τις 366 ημέρες ή τα start και end στάλθηκαν χωρίς range=custom.
503 source_history_unavailable Το ιστορικό πηγών δεν είναι προσωρινά διαθέσιμο και δεν υπάρχει αποθηκευμένο πρόσφατο αποτέλεσμα. Επαναλάβετε το αίτημα μετά τον χρόνο αναμονής που ορίζεται στην κεφαλίδα Retry-After.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}