REST API एंडपॉइंट

GET /v1/overview

पिछले N पूरे हो चुके इतिहास रिकॉर्ड के दैनिक पेजव्यू और विज़िट।

रिक्वेस्ट

GET https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7

यह ट्रेंड रिपोर्ट, BI इम्पोर्ट, स्प्रेडशीट एक्सपोर्ट और सीधे-सादे साप्ताहिक या मासिक सारांश के लिए बनाया गया संक्षिप्त रूट है।

प्रमाणीकरण

Authorization हेडर में API कुंजी देना आवश्यक है: Authorization: Bearer nm_YOUR_KEY.

क्वेरी पैरामीटर

नाम प्रकार आवश्यक विवरण
site string आवश्यक ट्रैकर ID। API कुंजी को इस ट्रैकर का एक्सेस प्राप्त होना चाहिए।
days integer वैकल्पिक लौटाए जाने वाले दिनों की संख्या। मानों को 1-30 की सीमा में रखा जाता है। डिफ़ॉल्ट: 30।

cURL उदाहरण

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

रिस्पॉन्स का उदाहरण

{
  "site": "TRACKER_ID",
  "timezone": "Europe/Zurich",
  "range": {
    "from": "2026-06-20",
    "to": "2026-06-26",
    "days": 7
  },
  "daily": [
    {
      "date": "2026-06-20",
      "pageviews": 81240,
      "visits": 53210
    },
    {
      "date": "2026-06-21",
      "pageviews": 77480,
      "visits": 50195
    },
    {
      "date": "2026-06-22",
      "pageviews": 48215,
      "visits": 31890
    }
  ],
  "totals": {
    "pageviews": 206935,
    "visits": 135295
  }
}

रिस्पॉन्स फ़ील्ड

फ़ील्ड प्रकार विवरण
site string रिक्वेस्ट में इस्तेमाल किया गया ट्रैकर ID।
timezone string स्थानीय तारीख निर्धारित करने के लिए इस्तेमाल किया गया ट्रैकर का समय क्षेत्र।
range.from string लौटाए गए दैनिक ऐरे की पहली तारीख।
range.to string लौटाए गए दैनिक ऐरे की आखिरी तारीख।
range.days integer लौटाई गई दैनिक पंक्तियों की संख्या।
daily[] array<object> तारीख के बढ़ते क्रम में व्यवस्थित दैनिक पंक्तियाँ।
daily[].date string YYYY-MM-DD फ़ॉर्मैट में तारीख।
daily[].pageviews integer उस तारीख के पेजव्यू।
daily[].visits integer उस तारीख की विज़िट।
totals.pageviews integer लौटाई गई दैनिक पंक्तियों के पेजव्यू का योग।
totals.visits integer लौटाई गई दैनिक पंक्तियों की विज़िट का योग।

डेटा की ताज़गी और कैशिंग

हर ट्रैकर और days मान के आधार पर रिस्पॉन्स को 60 सेकंड के लिए माइक्रोकैश किया जाता है। अचानक बढ़े ट्रैफ़िक से सुरक्षा के लिए थोड़ी देर तक पुराना डेटा भी परोसा जा सकता है।

एरर

HTTP कोड विवरण
400 site_required आवश्यक site पैरामीटर मौजूद नहीं है।
401 missing_token Authorization हेडर मौजूद नहीं है।
401 invalid_token टोकन अमान्य है या रद्द किया जा चुका है।
403 site_not_authorized API कुंजी को इस ट्रैकर का एक्सेस प्राप्त नहीं है।
429 rate_limit_exceeded अनुमत अनुरोध सीमा पार हो गई है।
503 redis_unavailable रीयलटाइम बैकएंड अस्थायी रूप से उपलब्ध नहीं है। 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}