GET /v1/sources-history
Verkeersmix in de tijd: het gemiddelde aantal gelijktijdige lezers per broncategorie over het afgelopen uur, de afgelopen 24 uur, vandaag, gisteren, de afgelopen 7 dagen of een aangepaste periode.
Aanvraag
De historische brongegevens worden sinds 16 november 2026 bijgehouden en nemen dagelijks toe. De registratie begon rond 16:00 UTC. Daardoor bevat 16 november alleen gegevens over de avond en is de dagwaarde niet vergelijkbaar met die van volledige dagen. Als een periode teruggaat tot vóór 16 november 2026, wordt from verplaatst naar die datum en bevat de respons een melding. Eindigt de periode vóór die datum, dan bevat de respons geen punten. Eerdere perioden worden nooit als nul gerapporteerd.
https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today
Gebruik dit endpoint om te zien hoe de verkeersmix zich in de tijd heeft ontwikkeld, bijvoorbeeld wanneer het verkeer via Google Discover op gang kwam of het organische zoekverkeer zwakker is dan gisteren. Elk datapunt bevat het gemiddelde aantal gelijktijdige lezers per broncategorie op dat moment. Dit zijn geen bezoeken of Pageviews; tel de waarden niet bij elkaar op over de tijd. Gebruik /v1/recap of /v1/overview voor totalen. Gebruik voor afzonderlijke livebronnen, zoals een specifiek sociaal netwerk of een nieuwsbrief, /v1/sources.
Uitproberen in de API PlaygroundAuthenticatie
Voor deze aanvraag is een API-sleutel vereist in de Authorization-header: Authorization: Bearer nm_YOUR_KEY.
Queryparameters
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
site |
string |
vereist | Tracker-ID. De API-sleutel moet toegang hebben tot deze tracker. |
range |
string |
optioneel | Tijdsperiode. Een van 1h (de laatste 60 minuten, punten per 2 minuten), 24h (de afgelopen 24 uur, punten per 10 minuten), today en yesterday (kalenderdag in de tijdzone van de tracker, punten per 10 minuten), 7d (vandaag en de voorgaande 6 dagen, punten per uur) of custom (vereist start en end). Standaard: today. |
start |
string |
optioneel | Eerste kalenderdag van een aangepaste periode, in de notatie YYYY-MM-DD en in de tijdzone van de tracker. Vereist bij range=custom en niet toegestaan bij andere perioden. Mag niet in de toekomst liggen. |
end |
string |
optioneel | Laatste kalenderdag van een aangepaste periode, in de notatie YYYY-MM-DD. Deze dag telt mee. Vereist bij range=custom. Een periode mag maximaal 366 dagen beslaan; een einddatum in de toekomst wordt begrensd op het huidige tijdstip. De resolutie is afhankelijk van de dagen waarvoor gegevens zijn geregistreerd: bij perioden van maximaal 2 dagen punten per 10 minuten, bij perioden van maximaal 31 dagen punten per uur en bij langere perioden dagpunten. |
cURL-voorbeeld
curl -H "Authorization: Bearer nm_YOUR_KEY" \
"https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today"
Voorbeeldrespons
{
"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
}
}
]
}
Responsvelden
| Veld | Type | Beschrijving |
|---|---|---|
site |
string |
Tracker-ID dat voor de aanvraag is gebruikt. |
range |
string |
Aangevraagde periode. |
start |
string|null |
Aangevraagde eerste dag voor range=custom; anders null. |
end |
string|null |
Aangevraagde laatste dag voor range=custom; anders null. |
timezone |
string |
Tijdzone van de tracker die wordt gebruikt voor kalenderdagen en tijdstempels, bijvoorbeeld Europe/Zurich. |
unit |
string |
Altijd avg_concurrent_readers: gemiddeld aantal lezers dat binnen elk datapunt gelijktijdig actief is. |
resolution_minutes |
integer |
Duur van elk datapunt in minuten: 2, 10, 60 of 1440 (één kalenderdag). |
from |
string |
Begin van de periode als ISO 8601-tijdstempel met de tijdzone-offset van de tracker. Begint de aangevraagde periode vóór data_available_from, dan wordt deze waarde verplaatst naar die datum. |
to |
string |
Einde van de periode als ISO 8601-tijdstempel met offset. Bij lopende perioden is dit het huidige tijdstip. |
data_available_from |
string |
Eerste dag waarvoor bronhistorie is geregistreerd: 2026-11-16. De registratie begon die dag rond 16:00 UTC, dus het is een onvolledige dag. |
notice |
object|null |
Ingesteld als de periode teruggaat tot vóór data_available_from; anders null. De aanvraag wordt wel succesvol verwerkt met HTTP 200. |
notice.code |
string |
partial_history: de periode begint eerder, dus from is verplaatst en voor eerdere dagen zijn geen punten beschikbaar. no_history: de periode eindigt vóór de start van de gegevensregistratie, dus points is leeg. |
notice.message |
string |
Korte Engelstalige toelichting voor logboeken of weergave. |
updated_at |
string |
UTC-tijdstempel van het moment waarop de historie is berekend. |
stale |
boolean |
true als dit het laatste geldige resultaat is omdat de backend voor de historie tijdelijk niet beschikbaar is. |
categories[] |
array<string> |
Alle broncategorieën in een vaste volgorde: organic, discover, direct, internal, social, referral, email, ai. De lijst is altijd volledig, ook als een categorie geen lezers had. |
points[] |
array<object> |
Punten in chronologische volgorde. Tijdstippen waarvoor geen gegevens zijn verzameld, worden weggelaten; er kunnen dus hiaten zijn. |
points[].t |
string |
Begin van het datapunt als ISO 8601-tijdstempel met offset. Wanneer aan het einde van de zomertijd de klok wordt teruggezet, wordt het herhaalde uur samengevoegd tot één datapunt. |
points[].total |
number |
Gemiddeld aantal gelijktijdige lezers over alle bronnen, afgerond op één decimaal. |
points[].unattributed |
number |
Lezers in total die niet aan een categorie kunnen worden toegewezen. Dit is momenteel meestal 0, waardoor de categorieën optellen tot total. Bereken aandelen altijd als de categoriewaarde gedeeld door total, zodat het resultaat ook klopt als er niet-toegewezen lezers zijn. |
points[].values |
object |
Gemiddeld aantal gelijktijdige lezers per categorie, met de namen uit categories als sleutels. Categorieën zonder lezers hebben de waarde 0. |
Actualiteit en caching
Responsen worden per tracker en periode gecachet: 60 seconden voor 1h, 24h en today, 5 minuten voor 7d en 30 minuten voor yesterday. Aangepaste perioden worden gecachet op basis van de begin- en einddatum: 30 minuten als de periode is afgelopen, anders 60 seconden bij punten per 10 minuten en 5 minuten bij punten per uur of per dag. Als de backend voor de historie tijdelijk niet beschikbaar is, wordt het laatste geldige resultaat teruggestuurd met stale: true en een Warning-header. De respons bevat ook X-NowMetrix-Microcache met HIT, MISS of STALE.
Foutmeldingen
| HTTP | Code | Beschrijving |
|---|---|---|
| 400 | site_required |
De verplichte parameter site ontbreekt. |
| 401 | missing_token |
De Authorization-header ontbreekt. |
| 401 | invalid_token |
Het token is ongeldig of ingetrokken. |
| 403 | site_not_authorized |
De API-sleutel heeft geen toegang tot deze tracker. |
| 429 | rate_limit_exceeded |
De aanvraaglimiet is overschreden. |
| 503 | redis_unavailable |
De realtimebackend is tijdelijk niet beschikbaar. |
| 400 | invalid_range |
De parameter range moet 1h, 24h, today, yesterday, 7d of custom zijn. |
| 400 | invalid_date_range |
start of end ontbreekt of is geen geldige datum in de notatie YYYY-MM-DD, start valt na end of in de toekomst, de periode beslaat meer dan 366 dagen, of start en end zijn meegestuurd zonder range=custom. |
| 503 | source_history_unavailable |
De bronhistorie is tijdelijk niet beschikbaar en er is geen recent resultaat gecachet. Wacht de periode af die in de Retry-After-header is aangegeven en probeer het daarna opnieuw. |
{
"error": {
"code": "invalid_token",
"message": "Bearer token is invalid or revoked."
}
}