GET /v1/realtime | NowMetrix REST API दस्तावेज़

अनुरोध

GET https://api.nowmetrix.com/v1/realtime?site=TRACKER_ID

जब किसी डैशबोर्ड, न्यूज़रूम डिस्प्ले, अलर्ट या हल्के इंटीग्रेशन को किसी एक ट्रैकर की मौजूदा लाइव स्थिति चाहिए, तब इस एंडपॉइंट का उपयोग करें।

प्रमाणीकरण

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

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

नाम	प्रकार	आवश्यक	विवरण
`site`	`string`	आवश्यक	ट्रैकर ID। API कुंजी से इस ट्रैकर का डेटा ऐक्सेस किया जा सकता हो।

cURL उदाहरण

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

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

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_realtime": 128,
  "total_pageviews_today": 48215,
  "total_unique_visitors_today": 31890,
  "devices": {
    "mobile": 91,
    "desktop": 37
  },
  "top_pages": [
    {
      "url": "/news/global-market-update",
      "host": "example-media.test",
      "title": "Global market update: what changed today",
      "og_image": "https://thumbs.nowmetrix.com/thumbnails/example.jpg",
      "realtime_users": 34,
      "pageviews_today": 6240,
      "sources": [
        {
          "medium": "social",
          "source": "social.example",
          "count": 18,
          "percent": 53,
          "children": []
        },
        {
          "medium": "search",
          "source": "Google Search",
          "count": 9,
          "percent": 26,
          "children": [
            {
              "label": "google.com",
              "count": 9
            }
          ]
        }
      ]
    }
  ],
  "countries": [
    {
      "code": "CH",
      "name": "Switzerland",
      "count": 52
    },
    {
      "code": "DE",
      "name": "Germany",
      "count": 31
    }
  ],
  "cities": [
    {
      "name": "Zurich",
      "count": 21
    },
    {
      "name": "Berlin",
      "count": 13
    }
  ],
  "sources_top5": [
    {
      "medium": "(none)",
      "source": "(direct)",
      "count": 44,
      "percent": 34,
      "children": []
    }
  ]
}

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

फ़ील्ड	प्रकार	विवरण
`site`	`string`	अनुरोध में उपयोग किया गया ट्रैकर ID।
`updated_at`	`string`	पेलोड तैयार किए जाने का UTC टाइमस्टैम्प।
`total_realtime`	`integer`	मौजूदा लाइव विंडो में सक्रिय उपयोगकर्ताओं की संख्या।
`total_pageviews_today`	`integer`	आज इस ट्रैकर के लिए दर्ज किए गए कुल पेजव्यू।
`total_unique_visitors_today`	`integer`	आज दर्ज किए गए अनुमानित विशिष्ट विज़िटर।
`devices.mobile`	`integer`	मोबाइल के रूप में वर्गीकृत सक्रिय उपयोगकर्ता।
`devices.desktop`	`integer`	डेस्कटॉप के रूप में वर्गीकृत सक्रिय उपयोगकर्ता।
`top_pages[]`	`array<object>`	रियलटाइम उपयोगकर्ताओं की संख्या के आधार पर क्रमबद्ध अधिकतम 50 लाइव पेज।
`top_pages[].url`	`string`	पेज का पाथ।
`top_pages[].host`	`string`	पेज के लिए रिपोर्ट किया गया होस्टनेम।
`top_pages[].title`	`string`	पेज का शीर्षक; शीर्षक उपलब्ध न होने पर पाथ का उपयोग किया जाता है।
`top_pages[].og_image`	`string`	पेज के थंबनेल का URL।
`top_pages[].realtime_users`	`integer`	इस समय इस पेज पर मौजूद सक्रिय उपयोगकर्ता।
`top_pages[].pageviews_today`	`integer`	आज इस पेज के पेजव्यू।
`top_pages[].sources[]`	`array<object>`	इस पेज के ट्रैफ़िक स्रोतों का विवरण, जिसमें /v1/sources के समान पंक्ति फ़ॉर्मैट का उपयोग किया गया है।
`countries[]`	`array<object>`	शीर्ष देशों के कोड, अंग्रेज़ी नाम और संख्या।
`cities[]`	`array<object>`	शीर्ष शहरों के नाम और संख्या।
`sources_top5[]`	`array<object>`	लाइव विंडो के शीर्ष 5 वैश्विक ट्रैफ़िक स्रोत।

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

हर ट्रैकर के लिए रिस्पॉन्स 8 सेकंड तक माइक्रोकैश किए जाते हैं। रिस्पॉन्स में HIT या MISS के साथ X-NowMetrix-Microcache भी शामिल होता है।

त्रुटियाँ

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."
  }
}