Credits and usage

Repull credits are pay-as-you-go for the Repull API. Your plan includes a monthly number of requests; with credits on your account, you keep going past it at $1 per 1,000 requests, without changing plans. It's the easy way to build and test before you commit to a subscription.

How it works

  • Your plan's quota comes first.Free includes 1,000 requests a month and Starter 100,000. Credits are only used once you're past that.
  • Only successful requests count. Requests we refuse or fail on (any 4xx or 5xx response) are never charged.
  • Billed hourly, in cents. Usage beyond your quota is deducted from your balance every hour, rounded down to whole cents (10 requests = $0.01).
  • One balance for your whole account. Workspaces created under your account draw on the same credits and the same quota.
  • Limits that stay in place. While you run on credits your daily cap rises to 25,000 requests, and the 600 requests per minute per API key limit still applies. Both protect you from a runaway loop.
  • Listings.Credits pay for requests, not listings. The Free plan's 3 active listings still apply; for more, move to Starter.

An example

You're on Free and make 21,000 requests this month. The first 1,000 are included; the other 20,000 cost $20 from your credits. Once you're steadily near 100,000 requests a month, Starter ($99 a month, 100,000 requests included) costs less.

Topping up

Go to Billing and pick an amount: $10, $50, $100 or $500, or any amount between $5 and $5,000. You pay through Stripe Checkout, and every top-up comes with an invoice for your records. Credits are available within a minute of payment.

Auto-recharge

After your first top-up, Repull saves your card and offers auto-recharge, so your integration never stops at a zero balance.

  • Threshold: when your balance drops below it, Repull recharges automatically.
  • Top-up amount: how much to add each time.

You can turn it off any time on the Billing page. If a recharge fails (an expired card, for example), credits are paused until you top up.

When credits run out

Requests within your plan's monthly quota keep working. Requests beyond it return 402 credits_exhausted until you top up; they resume within a minute. Your data, listings and connections are never affected.

Without credits on your account, reaching the quota returns 429 rate_limit_exceeded with scope: "monthly" until the next month, as before.

Checking your balance

The Billing page shows your balance and roughly how many requests it covers. From code, call GET /v1/usage/summary: the credits object returns balanceUsd, active and requestsCovered. Responses served on credits carry an X-Repull-Billing: credits header and your current balance in X-Repull-Credit-Balance.

Transaction history

Every top-up and every hourly charge is listed in your credit history, with the number of requests each charge covered and your balance after it.

If a plan payment fails

When your plan's renewal payment is declined, nothing is blocked: your API calls keep working while the card is retried automatically. The dashboard shows a banner with the amount, the date it failed and the next retry, with Pay now (the invoice) and Update card.

From code, every successful JSON response carries a billingNotice next to planNotice, until the invoice is paid:

"billingNotice": {
  "code": "payment_failed",
  "amount": 99,
  "currency": "usd",
  "failedAt": "2026-11-12T14:52:17.000Z",
  "nextRetryAt": "2026-11-14T20:52:16.000Z",
  "payUrl": "https://invoice.stripe.com/i/...",
  "message": "Your $99.00 Repull plan payment failed on Nov 12, 2026. Your API calls keep working. Stripe retries the card automatically on Nov 14, 2026.",
  "fix": "Pay the invoice at `payUrl`, or update the card at https://repull.dev/dashboard/billing (Manage billing) so the next retry goes through. This notice disappears once it is paid.",
  "billingUrl": "https://repull.dev/dashboard/billing"
}

nextRetryAt is null when no automatic retry is left. If you build for your own customers, show them the message and the payUrl.

AI