Core concepts
Credits & pricing
One credit balance per account powers REST, the App and MCP. Credits are metered per result — and failed, empty and blocked calls are always free.
You pay for data delivered, not attempts
Failed, empty, blocked and not-found calls charge
0 credits. In a fan-out, each failed platform is free and only the successful, non-empty legs are billed. See the failed-calls-free rule.Credit costs by endpoint
Credits are metered per result. Search, reviews and availability bill per returned item above a small per-leg minimum (the + below); listing, price and price-compare are flat per call. These are the launch defaults (1 credit ≈ $0.01 nominal retail).
| Endpoint | Credits | Billing unit |
|---|---|---|
/v1/listing | 3 | flat, per call |
/v1/price | 3 | flat, per call |
/v1/reviews | 5+ | per returned review, min 5 per platform |
/v1/availability | 5+ | by requested date range, min 5 per listing |
/v1/search | 5+ | per returned result, min 5 per platform |
/v1/price-compare | 22 | flat, per call (one property, many OTAs) |
/v1/jobs/{jobId} | 0 | polling is always free |
Plans & top-ups
| Plan | Price / mo | Credits / mo | Rate limit |
|---|---|---|---|
| Free / Sandbox | $0 (no card) | 300 · valid 90 days | 30 / min |
| Starter | $19 | 1,900 | 60 / min |
| Pro | $99 | 9,900 | 120 / min |
| Scale | $499 | 49,900 | 300 / min |
| Enterprise | Custom | Custom | Custom |
Top-up packs: $10 → 1,000, $50 → 5,000, $200 → 20,000. See the pricing page for the full breakdown and a credit calculator. Top-ups are a subscriber add-on: POST /v1/billing/topups returns 403 subscription_required for an account with no active paid plan.
How credits behave
- One balance per account. REST keys, the App and the MCP/Connectors channel all draw from the same ledger.
- Cache hits still bill at the full endpoint tier — caching is our margin lever, not a customer discount. Polling
/jobsis the one exception (always 0). - Charge on success only, pre-authorized via a reservation: a low balance is rejected with
402 insufficient_creditsbefore any upstream spend. - Credits expire on a schedule. Your free signup grant of 300 credits is valid for 90 days; monthly subscription credits reset each period and don’t roll over (unused monthly credits expire at the end of the billing period); top-up credits stay valid for at least 30 days — and while you’re subscribed, at least until your next renewal. Usage always spends the soonest-to-expire credits first.
Read your usage
meta.creditsCharged reports the total for a request, and meta.platformResults[].creditsCharged breaks it down per platform. The dashboard shows the full ledger and per-endpoint usage over time.Check your balance from code
Call
GET /v1/account to read your current credits.balance, plan and rate limit programmatically — it’s free (0 credits) and works for live and sandbox keys. Per call, meta.creditsCharged still tells you exactly what that request cost.