Credits & Billing
Understanding how credits work and what you pay for.
What Are Credits?
Credits are the unit of billing in ScraperCompany. Successful API requests consume credits based on the endpoint and data sources accessed.
Pay Only for Success
You are only charged for successful requests. If a request fails for any reason—timeouts, rate limits, site outages, parsing errors, or 4xx/5xx responses—you don't pay.
✓ What's a Successful Request?
A successful request returns valid hotel rate data with a 200 status code. Failed requests (422, 500, timeouts) are free.
Credit Costs by Endpoint
| Endpoint | Credits | Description |
|---|---|---|
/v1/search | 1 | Find property token |
/v1/calendar | 1 | 90-night horizon (one RPC) |
/v1/stay | 1 | Explicit check-in/check-out |
/v1/offers | ~5 | Per-OTA breakdown (multi-MB pages) |
/v1/rooms | ~5 | Room matrix across OTAs |
/v1/ota/booking | 2 | Booking.com 61-date GraphQL |
/v1/ota/hotels | 1 | Hotels.com single-date |
/v1/ota/agoda | 1 | Agoda with room ladder |
/v1/official | 1-3 | Official booking engine (varies) |
Monthly Plans
All plans include a monthly credit allowance and concurrent request limits. See pricing page for current plans.
Free Tier
- 1,000 successful requests per month
- 2 concurrent requests
- All endpoints unlocked
- No credit card required
Paid Plans
- Starter: 10,000 credits/month, 5 concurrent
- Growth: 100,000 credits/month, 20 concurrent
- Enterprise: Custom credits, unlimited concurrent
Overage & Top-ups
If you exceed your monthly credit allowance:
- Requests will fail with
429 Rate Limitresponse - Purchase credit top-ups from your dashboard
- Top-ups never expire
- Upgrade your plan for automatic renewal
Usage Tracking
Monitor your credit usage in real-time from your dashboard:
- Total credits used this month
- Credits by endpoint
- Credits by day
- Current balance
- Request history with per-request credit cost
Pro tip: Use /v1/calendar for bulk rate collection (1 credit per 90 nights). Reserve /v1/offers for detailed per-OTA breakdown only when needed (~5 credits).
Request History & Transparency
Every API response includes:
x-request-idheader for tracking- Detailed request logs in your dashboard
- Downloadable usage reports
- Per-request credit cost breakdown
Access your full request history at GET /v1/requests or through the dashboard.