Usage API

Track your API usage, credit consumption, and access detailed analytics on your API calls.

GET/v1/usage

Parameters

Parameter	Type	Required	Description
`start_date`	string	Optional	Start date in YYYY-MM-DD format
`end_date`	string	Optional	End date in YYYY-MM-DD format
`endpoint`	string	Optional	Filter by specific endpoint

Response

{
  "records": [
    {
      "date": "2025-01-15",
      "endpoint": "/v1/paper-search/google",
      "calls": 45,
      "credits_used": 45
    },
    {
      "date": "2025-01-15",
      "endpoint": "/v1/citation/verify",
      "calls": 12,
      "credits_used": 24
    }
  ],
  "total_credits_used": 69
}

Examples

import requests

response = requests.get(
    "https://api.qinyanai.com/v1/usage",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "start_date": "2025-01-01",
        "end_date": "2025-01-31",
    }
)

data = response.json()
print(f"Total credits used: {data['total_credits_used']}")