Account & Usage

Check your API usage, tier, and rate limits.

Get Usage Stats

GET /api/usage

Returns your current tier, daily usage, and account stats.

Response

{
  "status": "ok",
  "tier": "starter",
  "requests_today": 47,
  "requests_limit": 500,
  "creators_tracked": 12,
  "alerts_count": 3,
  "tier_limits": {
    "free": 50,
    "starter": 500,
    "pro": 2000
  },
  "last_used_at": "2026-07-26T15:30:00Z"
}

Fields

Field	Description
tier	Your current plan (free, starter, pro)
requests_today	Requests used today
requests_limit	Your daily request limit
creators_tracked	Number of creators you're tracking
alerts_count	Total alerts received
tier_limits	Limits for all tiers
last_used_at	When you last made an API call

Rate Limit Headers

Every response includes rate limit headers:

Header	Description
X-RateLimit-Limit	Your daily request limit
X-RateLimit-Remaining	Requests remaining today
X-RateLimit-Reset	UTC time when limits reset (midnight)

What Counts as a Request

• Every API call counts as 1 request, regardless of how much data it returns
• /api/discover internally calls YouTube but only costs you 1 request
• /api/creators/youtube/:id costs 1 request (YouTube lookup included)
• /api/creators/search costs 1 request (YouTube search included)

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/usage"

Checking Remaining Quota

# Check usage before making expensive calls
curl -s -D - -H "X-API-Key: YOUR_KEY" \
  "https://beta.pushapi.xyz/api/usage" | grep -i "x-ratelimit"

Returns headers like:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 453
X-RateLimit-Reset: 2026-07-27T00:00:00Z