Skip to content
Docs

FAQ

Answers to common questions about API keys, credits and failed requests, rate limits, data freshness, international hotels, AI agents and paid plans.

How do I get an API key?

Sign up on the sign-up page (https://api.scrapercompany.com/signup) and verify your email; your free trial (50 calls or 14 days, whichever ends first, no card needed) starts then. Once signed in, create your API key on the API access page (it looks like sk_ followed by random characters). The full key is shown once, when it is created.

How does "failures are free" work?

Only successful calls (HTTP 2xx) consume credits. Failed or blocked requests — validation errors, upstream failures, timeouts, rate-limited calls — cost 0 credits, and so do empty results such as a comparison where no OTA returned a price.

What happens when I use up my monthly credits?

A request that needs more credits than you have returns HTTP 402. Buy a credit pack (from $15, valid 12 months) or upgrade your plan in the dashboard; a plan's credits also renew at the start of each billing period. Check your balance any time with GET /v1/billing.

How do I see what I have used?

Every metered response carries x-credits-charged and x-credits-remaining headers. GET /v1/billing returns your plan, balance and period, GET /v1/billing/ledger lists every credit movement, and GET /v1/usage and GET /v1/requests show request counts and history. All of these are free.

Can I use the API for commercial purposes?

Yes. ScraperCompany is built for commercial use, subject to our Terms of Service. You are responsible for how you use the data.

How fresh is the rate data?

Live endpoints collect from the source when you call them, and responses say when the data was observed (for example observed_at on calendar responses). The stored-rates endpoints return the latest stored observation instead. Latency depends on the source: a Google Hotels calendar call usually takes well under a second, while an official-site call can take up to a minute.

Do you support international hotels?

Yes. Google Hotels, Booking.com, Hotels.com, Agoda, Tripadvisor, Hostelworld and Airbnb all have global inventory, and the Google endpoints take a market and currency so you see the prices a guest in that market would see. Expedia is priced through its US and Canadian points of sale and Vrbo through its US site.

Can I get historical rate data?

The API returns current and forward-looking prices. There is no historical archive to query; to build history, store responses over time.

What's the difference between OTA and official-site rates?

OTA rates come from online travel agencies such as Booking.com and Hotels.com (12 credits per single-source call). Official-site rates come from the hotel's own booking engine (4 credits per call, 50+ engines supported). For rate parity monitoring you usually need both; OTA compare fans out across OTAs in one call (30 credits).

How do rate limits and concurrency work?

Each API key has a requests-per-minute sliding window that depends on the plan (Starter 300, Growth 1,200, Scale 3,000, Business 4,500; the free trial 10). Plans also cap concurrent requests (the trial 1, Starter 10, Growth 40, Scale 100, Business 150). Above either limit the API returns HTTP 429.

How do I buy a plan or credits?

Now. Pick a monthly plan (Starter $49 for 40,000 credits, Growth $149 for 150,000, Scale $399 for 500,000, Business $999 for 1,500,000) or buy a one-time credit pack ($15, $60 or $200) from the billing page of your dashboard. For more, email [email protected].

What happens if a hotel name or location changes?

Property tokens and OTA ids are usually stable. If a call starts returning 404 for a property, resolve it again by name with /v1/search or the OTA search endpoints.

Can I request new data sources or endpoints?

Yes. Email [email protected] with your use case and we will evaluate it.

Is there an SLA for uptime?

No uptime SLA is offered on self-serve plans. Enterprise terms are agreed individually.

Is there anything to cancel or refund?

Cancel a plan any time in the billing portal; it stays active until the end of the billing period. Unused purchased credit from packs bought in the last 60 days can be refunded from the billing page. Plan fees and plan credits are not refundable. See the Terms of Service.

What programming languages do you support?

ScraperCompany is a REST API, so any language that can make HTTP requests works. The docs include cURL, Python and Node.js examples, and the OpenAPI spec can generate clients for other languages.

Can AI agents use the API?

Yes. The MCP server at https://api.scrapercompany.com/mcp gives Model Context Protocol clients such as Claude Code, Claude Desktop, ChatGPT and Cursor tools for hotel rates, flights, vacation rentals, guest reviews, rate monitoring and search data. A plain connection gets a default set of read-only hotel and flight tools, and you add tool groups by name. It signs in with OAuth or takes your API key, and each tool call is priced like the REST call it wraps. See the MCP server docs.

Do you offer volume pricing?

Enterprise pricing is custom. Contact [email protected] to discuss your volume.

How do I authenticate my requests?

Send your API key in the x-api-key header: x-api-key: YOUR_API_KEY. Authorization: Bearer YOUR_API_KEY also works. See the Authentication docs for details.

How do I rotate or revoke a key?

Rotate it yourself from the dashboard (API access page) — the old key stops working immediately and the new one is shown once. For a revocation without a replacement, email [email protected].

Can I allowlist IP addresses?

IP allowlisting is not available. Keep your key on the server side and never ship it in browser code.

What if I hit a rate limit?

You will receive HTTP 429. The REST API sends no rate-limit or Retry-After headers, so pace requests below your per-minute limit and retry 429, 502 and 503 responses with exponential backoff.

Still have questions?

We're here to help. Reach out to our support team.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support