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

अनुरोध

GET https://api.nowmetrix.com/v1/sources?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/sources?site=TRACKER_ID"

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

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_visitors": 128,
  "sources": [
    {
      "medium": "search",
      "source": "Google Search",
      "count": 46,
      "percent": 36,
      "children": [
        {
          "label": "google.com",
          "count": 28
        },
        {
          "label": "google.ch",
          "count": 18
        }
      ]
    },
    {
      "medium": "social",
      "source": "social.example",
      "count": 24,
      "percent": 19,
      "children": []
    },
    {
      "medium": "newsletter",
      "source": "morning-briefing",
      "count": 17,
      "percent": 13,
      "children": [
        {
          "label": "daily-edition",
          "count": 11
        },
        {
          "label": "evening-edition",
          "count": 6
        }
      ]
    }
  ]
}

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

फ़ील्ड	प्रकार	विवरण
`site`	`string`	अनुरोध में उपयोग किया गया ट्रैकर ID।
`updated_at`	`string`	पेलोड तैयार किए जाने का UTC टाइमस्टैम्प।
`total_visitors`	`integer`	स्रोत-विवरण में शामिल सक्रिय उपयोगकर्ताओं की संख्या।
`sources[]`	`array<object>`	गिनती के अनुसार क्रमबद्ध स्रोत रो।
`sources[].medium`	`string`	स्रोत की श्रेणी, जैसे search, social, newsletter, (none) या (not set), जब utm_source में utm_medium न दिया गया हो।
`sources[].source`	`string`	मानकीकृत स्रोत लेबल।
`sources[].count`	`integer`	इस स्रोत से आए सक्रिय उपयोगकर्ताओं की संख्या।
`sources[].percent`	`integer`	कुल विज़िटर का निकटतम पूर्णांक तक पूर्णांकित प्रतिशत।
`sources[].children[]`	`array<object>`	वैकल्पिक विस्तृत रो, जैसे सर्च होस्टनेम या कैंपेन नाम।
`sources[].children[].label`	`string`	चाइल्ड रो का लेबल।
`sources[].children[].count`	`integer`	चाइल्ड रो की गिनती।

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

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

त्रुटियाँ

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