GET /v1/usage

Returns your current API usage and plan information.

Use case: Use this to monitor your API quota before making bulk requests, or to display usage info in your own dashboard.

Request

bash

curl -H "x-api-key: YOUR_KEY" https://api.buska.io/api/v1/usage

Response

json

{
      "team": "Acme Corp",
      "plan": "growth",
      "usage": {
        "used": 45,
        "limit": 500,
        "remaining": 455,
        "month": "2026-08",
        "resetsAt": "2026-09-01T00:00:00.000Z"
      },
      "credits": 0,
      "availablePlatforms": ["twitter", "reddit", "linkedin", "youtube"]
    }

Response fields

Field	Type	Description
team	string	Your team name
plan	string	Current plan (starter, growth, scale)
usage.used	number	Requests used this month
usage.limit	number	Monthly request limit
usage.remaining	number	Requests remaining
usage.month	string	Billing month the counters apply to (YYYY-MM)
usage.resetsAt	ISO date	When the counter resets (1st of next month)
credits	number	Pay-as-you-go credits, spent once the monthly quota is used up
availablePlatforms	string[]	Platforms your plan can search

Buska API: GET /v1/usage endpoint reference

GET /v1/usage

Request

Response

Response fields

Related guides