REST API एंडपॉइंट

GET /v1/pulse

आज का पल्स, कल से तुलना और दिन के दौरान 15-मिनट के अंतराल पर बने कर्व।

अनुरोध

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

Pulse की मदद से ‘हमारे पास कितना ट्रैफ़िक है?’ से अधिक उपयोगी सवाल का जवाब पाएँ: सप्ताह के इस दिन और समय के सामान्य पैटर्न की तुलना में आज ट्रैफ़िक अधिक है या कम?

प्रमाणीकरण

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

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

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

cURL उदाहरण

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

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

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30Z",
  "timezone": "Europe/Zurich",
  "pulse": {
    "available": true,
    "reason": null,
    "delta_percent": 12,
    "days_counted": 8,
    "is_provisional": false,
    "minute_of_day": 865,
    "metrics": {
      "pageviews": {
        "today": 48215,
        "avg": 43040,
        "delta_percent": 12
      },
      "visitors": {
        "today": 31890,
        "avg": 29620,
        "delta_percent": 8
      },
      "active_users": {
        "today": 128,
        "avg": 104,
        "delta_percent": 23
      }
    },
    "baseline": {
      "snapshot_time": "14:25",
      "aggregation": "median",
      "combination": "mean_of_deltas",
      "days_counted": 8,
      "samples": [
        {
          "date": "2026-06-19",
          "pageviews": 42110,
          "visitors": 29100,
          "active_users": 98
        }
      ]
    }
  },
  "yesterday_vs_day_before": {
    "yesterday": {
      "date": "2026-06-25",
      "pageviews": 77480,
      "visitors": 50195
    },
    "day_before": {
      "date": "2026-06-24",
      "pageviews": 81240,
      "visitors": 53210
    },
    "delta_percent": {
      "pageviews": -5,
      "visitors": -6
    }
  },
  "chart": {
    "interval_minutes": 15,
    "today_date": "2026-06-26",
    "yesterday_date": "2026-06-25",
    "average_basis_days": 8,
    "average_method": "median_same_weekday",
    "pageviews": {
      "today": [
        {
          "time": "08:00",
          "value": 920
        },
        {
          "time": "08:15",
          "value": 1110
        }
      ],
      "yesterday": [
        {
          "time": "08:00",
          "value": 870
        }
      ],
      "average": [
        {
          "time": "08:00",
          "value": 810
        }
      ]
    },
    "visitors": {
      "today": [
        {
          "time": "08:00",
          "value": 620
        }
      ],
      "yesterday": [
        {
          "time": "08:00",
          "value": 580
        }
      ],
      "average": [
        {
          "time": "08:00",
          "value": 540
        }
      ]
    }
  }
}

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

फ़ील्ड प्रकार विवरण
site string अनुरोध में इस्तेमाल किया गया ट्रैकर ID।
updated_at string पेलोड तैयार किए जाने का UTC टाइमस्टैम्प।
timezone string स्थानीय तारीख तय करने के लिए इस्तेमाल किया गया ट्रैकर का टाइमज़ोन।
pulse.available boolean क्या पल्स की गणना के लिए पर्याप्त इतिहास उपलब्ध है।
pulse.reason string|null पल्स उपलब्ध न होने का कारण।
pulse.delta_percent integer|null बेसलाइन से कुल प्रतिशत अंतर।
pulse.days_counted integer बेसलाइन में शामिल दिनों की संख्या।
pulse.is_provisional boolean क्या पल्स का परिणाम अस्थायी है।
pulse.minute_of_day integer तुलना के लिए इस्तेमाल किए गए स्थानीय दिन का वर्तमान मिनट।
pulse.metrics.pageviews object पेजव्यू के लिए आज का मान, औसत और delta_percent।
pulse.metrics.visitors object विज़िटर के लिए आज का मान, औसत और delta_percent।
pulse.metrics.active_users object सक्रिय उपयोगकर्ताओं के लिए आज का मान, औसत और delta_percent।
pulse.baseline object पल्स की गणना में इस्तेमाल किए गए बेसलाइन मेटाडेटा और नमूना दिनों की जानकारी।
yesterday_vs_day_before object पेजव्यू और विज़िटर के लिए पूरे हो चुके दिनों की तुलना।
chart object पेजव्यू और विज़िटर के लिए अलग-अलग, आज, कल और औसत की 15-मिनट अंतराल वाली सीरीज़।

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

हर ट्रैकर के लिए रिस्पॉन्स 30 सेकंड तक माइक्रोकैश किए जाते हैं। अचानक बढ़े अनुरोधों से सुरक्षा के लिए 90 सेकंड की पुराना-डेटा अवधि भी रखी जाती है।

त्रुटियाँ

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