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

इस एंडपॉइंट से देखें कि समय के साथ ट्रैफ़िक मिक्स कैसे बदला—उदाहरण के लिए, 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."
  }
}