BazaarLinkBazaarLink
เข้าสู่ระบบ
เอกสารAPI ข้อมูลอ้างอิงSDK ข้อมูลอ้างอิงการใช้งาน AgentAI ทักษะ
บัญชี

รับข้อมูลเชิงลึกการใช้งาน

คืนค่าทุกอย่างที่หน้า /insights ต้องการในการเรียกครั้งเดียว: ชุดแนวโน้มสำหรับทั้ง 3 เมตริก (โทเค็น/ค่าใช้จ่าย/จำนวนคำขอ), 3 โมเดลอันดับต้นต่อเมตริก, สถิติการเข้า cache ของพรอมต์, การแจกแจงโทเค็น, ฮีตแมปรายปี (พร้อม streak), การใช้เครดิต/โมเดลฟรี และตัวเลือกแผงตัวกรอง แคช 5 นาทีต่อชุดค่าผสม (ผู้ใช้, period, heatmap_metric, ตัวกรอง)

GET/api/v1/insights

การอนุญาต

Authorizationจำเป็น
string · header

API key เป็น bearer token ใน header Authorization

พารามิเตอร์คิวรี

period
string

กำหนดช่วงเวลาของทั้งหน้า ค่าเริ่มต้น 7d ค่าที่ไม่รู้จักจะคืนค่า 400

7d30dytdall
Example: "30d"
heatmap_metric
string

เมตริกที่ฮีตแมปรายปีแสดง (ฮีตแมปเป็นปีปฏิทินเต็มเสมอ ไม่ขึ้นกับ period) ค่าเริ่มต้น spend ค่าที่ไม่รู้จักจะคืนค่า 400

spendtokensrequests
Example: "tokens"
model
string

ตัวกรองทั้งหน้า — นับเฉพาะการใช้งานของโมเดลนี้ ละไว้หมายถึงไม่มีตัวกรอง

api_key_id
string

ตัวกรองทั้งหน้า — นับเฉพาะการใช้งานของ API key นี้ ละไว้หมายถึงไม่มีตัวกรอง

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 คืนค่าข้อมูลเต็มของทั้ง 3 เมตริกเสมอ (tokens, spend, requests) ทำให้การสลับที่ฝั่งหน้าเว็บไม่ต้องเรียกใหม่ caching และ breakdown จะถูกแบ่งกลุ่มตาม period (รายวัน ≤120 วัน, รายสัปดาห์ ≤730 วัน, นอกนั้นรายเดือน) ตัวอย่างด้านล่างถูกย่อไว้ — อาร์เรย์ buckets/heatmap.days จริงจะมีหลายรายการตามความยาวของ period

{
  "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