BazaarLinkBazaarLink
साइन इन
दस्तावेज़API संदर्भSDK संदर्भएजेंटिक उपयोगAI स्किल्स
खाता

उपयोग अंतर्दृष्टि प्राप्त करें

/insights पेज को एक ही राउंड-ट्रिप में जो कुछ चाहिए वह सब लौटाता है: सभी 3 मेट्रिक्स (टोकन/खर्च/अनुरोध) के लिए ट्रेंड सीरीज़, प्रति मेट्रिक शीर्ष 3 मॉडल, प्रॉम्प्ट-कैश हिट आँकड़े, टोकन विवरण, वार्षिक हीटमैप (स्ट्रीक सहित), क्रेडिट/मुफ़्त मॉडल उपयोग, और फ़िल्टर पैनल विकल्प। (उपयोगकर्ता, period, heatmap_metric, फ़िल्टर) संयोजन के अनुसार 5 मिनट के लिए कैश किया जाता है।

GET/api/v1/insights

प्राधिकरण

Authorizationआवश्यक
string · header

Authorization हेडर में bearer token के रूप में API कुंजी।

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

period
string

पूरे पेज की समय-सीमा तय करता है, डिफ़ॉल्ट 7d। अपरिचित मान 400 लौटाता है।

7d30dytdall
Example: "30d"
heatmap_metric
string

वार्षिक हीटमैप कौन-सा मेट्रिक दिखाता है (हीटमैप हमेशा पूरा कैलेंडर वर्ष होता है, period से स्वतंत्र), डिफ़ॉल्ट spend। अपरिचित मान 400 लौटाता है।

spendtokensrequests
Example: "tokens"
model
string

पूरे पेज का फ़िल्टर — केवल इस मॉडल का उपयोग गिना जाता है। छोड़ने का अर्थ है कोई फ़िल्टर नहीं।

api_key_id
string

पूरे पेज का फ़िल्टर — केवल इस API कुंजी का उपयोग गिना जाता है। छोड़ने का अर्थ है कोई फ़िल्टर नहीं।

app
string

पूरे पेज का फ़िल्टर — केवल इस ऐप नाम (x-title / HTTP-Referer) से टैग किया गया उपयोग गिना जाता है। छोड़ने का अर्थ है कोई फ़िल्टर नहीं।

GET /api/v1/insights
curl "https://bazaarlink.ai/api/v1/insights?period=30d&heatmap_metric=tokens" \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"
प्रतिक्रिया उदाहरण

सफल। trend/topModels/heatmap हमेशा तीनों मेट्रिक्स (tokens, spend, requests) का पूरा डेटा लौटाते हैं ताकि फ्रंटएंड टॉगल को दोबारा फ़ेच न करना पड़े; caching और breakdown period के अनुसार बकेट किए जाते हैं (≤120 दिन दैनिक, ≤730 साप्ताहिक, अन्यथा मासिक)। नीचे दिया उदाहरण संक्षिप्त है — वास्तविक buckets/heatmap.days सरणियों में अवधि की लंबाई के अनुसार कई प्रविष्टियाँ होती हैं।

{
  "period": "30d",
  "bucketUnit": "day",
  "trend": {
    "tokens": {
      "total": 152000,
      "prevTotal": 98000,
      "changePct": 55.1,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 5200
            }
          ]
        }
      ]
    },
    "spend": {
      "total": 4.82,
      "prevTotal": 3.1,
      "changePct": 55.5,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 0.16
            }
          ]
        }
      ]
    },
    "requests": {
      "total": 340,
      "prevTotal": 210,
      "changePct": 61.9,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 12
            }
          ]
        }
      ]
    }
  },
  "topModels": {
    "tokens": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 152000,
        "unit": "tokens"
      }
    ],
    "spend": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 4.82,
        "unit": "spend"
      }
    ],
    "requests": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 340,
        "unit": "requests"
      }
    ]
  },
  "caching": {
    "buckets": [
      {
        "date": "2026-07-01",
        "hit": 3200,
        "write": 800
      }
    ],
    "totalHit": 96000,
    "totalWrite": 24000
  },
  "breakdown": {
    "buckets": [
      {
        "date": "2026-07-01",
        "prompt": 4000,
        "completion": 1200,
        "reasoning": 0,
        "cached": 3200
      }
    ],
    "totals": {
      "prompt": 120000,
      "completion": 32000,
      "reasoning": 0,
      "cached": 96000
    }
  },
  "heatmap": {
    "spend": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 0.02
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 0.16,
      "avgWeek": 1.12,
      "total": 58.4
    },
    "tokens": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 640
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 5066,
      "avgWeek": 35462,
      "total": 1850000
    },
    "requests": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 4
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 11.3,
      "avgWeek": 79,
      "total": 4130
    }
  },
  "credit": {
    "today": 0.16,
    "thisWeek": 1.12,
    "thisMonth": 4.82
  },
  "freeModel": {
    "today": 0,
    "thisWeek": 0,
    "thisMonth": 0
  },
  "facets": {
    "models": [
      "openai/gpt-4.1"
    ],
    "apiKeys": [
      {
        "id": "key_abc123",
        "name": "default"
      }
    ],
    "apps": [
      "my-app"
    ]
  }
}
Support
Support
Hi! How can we help you?
Send a message and we'll get back to you soon.
उपयोग अंतर्दृष्टि प्राप्त करें — BazaarLink API