Credits

How credits work

Every API call deducts credits from your balance. Different endpoints cost different amounts.

Check your balance

curl "https://api.rankparse.com/v1/credits" \
  -H "X-API-Key: rp_your_key_here"

Returns:

{ "credits": 842 }

This endpoint costs 0 credits.

Credit costs by endpoint

Buying credits

Credits are sold in one-time packs (no subscriptions):

Credits never expire. Buy them from the pricing page or your dashboard.

Insufficient credits

If your balance is too low for a request, you'll get a 402 response:

{
  "error": "payment_required",
  "code": "payment_required",
  "message": "Insufficient credits. Balance: 0, required: 2"
}

No credits are deducted on failed requests.