GET /v1/sources-history
समय के साथ ट्रैफ़िक मिक्स: पिछले घंटे, 24 घंटे, आज, कल, 7 दिनों या कस्टम तारीख़-सीमा के दौरान हर स्रोत श्रेणी में एक समय पर सक्रिय पाठकों की औसत संख्या।
अनुरोध
स्रोतों का इतिहास 16 नवंबर 2026 से दर्ज किया जा रहा है और हर दिन बढ़ता जाता है। रिकॉर्डिंग लगभग 16:00 UTC पर शुरू हुई थी, इसलिए 16 नवंबर के लिए केवल शाम के घंटों का डेटा उपलब्ध है और उस दिन का मान पूरे दिनों से तुलनीय नहीं है। अगर समय-सीमा 16 नवंबर 2026 से पहले तक जाती है, तो from को उस तारीख़ पर कर दिया जाता है और रिस्पॉन्स में एक सूचना शामिल होती है। अगर समय-सीमा उस तारीख़ से पहले समाप्त होती है, तो कोई पॉइंट नहीं मिलता। पहले के समय को कभी भी शून्य के रूप में नहीं दिखाया जाता।
https://api.nowmetrix.com/v1/sources-history?site=TRACKER_ID&range=today
इस एंडपॉइंट से देखें कि समय के साथ ट्रैफ़िक मिक्स कैसे बदला—उदाहरण के लिए, Google Discover से ट्रैफ़िक कब आना शुरू हुआ या ऑर्गेनिक सर्च कल से कमज़ोर है या नहीं। हर पॉइंट में उस समय हर स्रोत श्रेणी में एक समय पर सक्रिय पाठकों की औसत संख्या होती है। ये विज़िट या पेजव्यू नहीं हैं, इसलिए इन्हें समय के साथ जोड़ना नहीं चाहिए। कुल आँकड़ों के लिए /v1/recap या /v1/overview का इस्तेमाल करें। किसी खास सोशल नेटवर्क या न्यूज़लेटर जैसे अलग-अलग लाइव स्रोतों के लिए /v1/sources का इस्तेमाल करें।
API प्लेग्राउंड में आज़माएँप्रमाणीकरण
इसके लिए Authorization हेडर में API कुंजी देना ज़रूरी है: Authorization: Bearer nm_YOUR_KEY.
क्वेरी पैरामीटर
| नाम | प्रकार | ज़रूरी | विवरण |
|---|---|---|---|
site |
string |
ज़रूरी | ट्रैकर ID। API कुंजी को इस ट्रैकर का ऐक्सेस होना चाहिए। |
range |
string |
वैकल्पिक | समय-सीमा। इनमें से एक चुनें: 1h (पिछले 60 मिनट, हर 2 मिनट पर पॉइंट), 24h (लगातार पिछले 24 घंटे, हर 10 मिनट पर पॉइंट), today और yesterday (ट्रैकर के समय-क्षेत्र के अनुसार कैलेंडर दिवस, हर 10 मिनट पर पॉइंट), 7d (आज और पिछले 6 दिन, हर घंटे पर पॉइंट), या custom (इसके लिए start और end देना ज़रूरी है)। डिफ़ॉल्ट: today। |
start |
string |
वैकल्पिक | कस्टम समय-सीमा का पहला कैलेंडर दिवस, YYYY-MM-DD फ़ॉर्मैट में और ट्रैकर के समय-क्षेत्र के अनुसार। 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 |
अनुरोध में इस्तेमाल किया गया ट्रैकर ID। |
range |
string |
अनुरोध की गई समय-सीमा। |
start |
string|null |
range=custom के लिए अनुरोध किया गया पहला दिन; अन्यथा null। |
end |
string|null |
range=custom के लिए अनुरोध किया गया आख़िरी दिन; अन्यथा null। |
timezone |
string |
कैलेंडर दिनों और टाइमस्टैम्प के लिए इस्तेमाल किया गया ट्रैकर का समय-क्षेत्र, जैसे Europe/Zurich। |
unit |
string |
हमेशा avg_concurrent_readers: हर पॉइंट के दौरान एक ही समय पर सक्रिय पाठकों की औसत संख्या। |
resolution_minutes |
integer |
हर पॉइंट की अवधि मिनटों में: 2, 10, 60 या 1440 (एक कैलेंडर दिवस)। |
from |
string |
समय-सीमा की शुरुआत का ISO 8601 टाइमस्टैम्प, जिसमें ट्रैकर के समय-क्षेत्र का ऑफ़सेट शामिल है। अगर अनुरोध की गई समय-सीमा data_available_from से पहले शुरू होती है, तो 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 होता है। |
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 होता है। |
डेटा की ताज़गी और कैश
हर ट्रैकर और समय-सीमा के लिए रिस्पॉन्स कैश में रखे जाते हैं: 1h, 24h और today के लिए 60 सेकंड; 7d के लिए 5 मिनट; और yesterday के लिए 30 मिनट। कस्टम समय-सीमाओं के लिए कैश, शुरू और आख़िरी तारीख़ के आधार पर रखा जाता है: समय-सीमा समाप्त हो चुकी हो, तो 30 मिनट; अन्यथा 10-मिनट के अंतराल वाले डेटा के लिए 60 सेकंड और घंटे या दिन के अंतराल वाले डेटा के लिए 5 मिनट। अगर इतिहास का बैकएंड कुछ समय के लिए उपलब्ध न हो, तो पिछला मान्य नतीजा stale: true और Warning हेडर के साथ लौटाया जाता है। रिस्पॉन्स में X-NowMetrix-Microcache भी शामिल होता है, जिसका मान HIT, MISS या STALE होता है।
त्रुटियाँ
| HTTP | कोड | विवरण |
|---|---|---|
| 400 | site_required |
ज़रूरी site पैरामीटर नहीं दिया गया है। |
| 401 | missing_token |
Authorization हेडर मौजूद नहीं है। |
| 401 | invalid_token |
टोकन अमान्य है या रद्द किया जा चुका है। |
| 403 | site_not_authorized |
API कुंजी को इस ट्रैकर का ऐक्सेस नहीं है। |
| 429 | rate_limit_exceeded |
अनुरोधों की निर्धारित सीमा पार हो गई है। |
| 503 | redis_unavailable |
रीयल-टाइम बैकएंड कुछ समय के लिए उपलब्ध नहीं है। |
| 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."
}
}