Skip to content
Docs

Credits & billing

How requests are metered in credits, what each operation costs, the free trial, plans and credit packs, and the billing endpoints.

Free trial, plans and credit packs

  • Free trial: 50 calls or 14 days, whichever ends first, no card needed. It starts when you verify your email. Trial calls cover the travel endpoints (hotel search, rates, vacation rentals such as Airbnb and Vrbo, reviews, property details and flights) that cost up to 12 credits, one at a time. Car rental is not included; other endpoints need a plan or a credit pack.
  • Monthly plans: a credit allowance each billing period (table below). Plan credits are used first and do not roll over.
  • Credit packs: $15 for 7,500 credits, $60 for 35,000 credits, $200 for 125,000 credits. One-time, valid 12 months from purchase; on a plan they top up the allowance.

A request that needs more credits than you have gets 402, and a request above your plan's concurrency or rate limit gets 429 (see Errors). Buy a pack or change plan from the billing page of your dashboard.

How charging works

  1. When a metered request arrives, its cost is reserved on your account. For a cost that depends on the work (the Airbnb priced calendar), the most the request could cost is reserved.
  2. The request runs.
  3. On success (2xx) the reservation is captured. On any error (4xx or 5xx) it is released, so failed and blocked requests are free.
  4. Empty results are free too, even though they return 200: an OTA compare where no source returned a price, a calendar where no night priced, a destination-search page with no properties, and a Google Flights search, return-leg, booking-options or location search that found nothing.

An answer that carries information is charged even when it is a "no": an Expedia or Vrbo quote saying the stay can't be sold as asked (a minimum stay, dates taken) is billed like any other answer, because the reason is availability data. Only a reply with nothing in it is free.

Costs are fixed per operation, not per byte or per night: a calendar call costs 8 credits whether it prices 30 nights or 330. Calendar jobs charge each item as it succeeds, priced exactly like POST /v1/calendar with the same surcharges (8 for a default item). Google offers (POST /v1/offers) are 10 credits (14 with require_rooms). Two operations scale with the work they do: destination search (per page) and the Airbnb priced calendar (per priced night), below. Credits reset every period and do not roll over.

Cost by operation

OperationCreditsEndpoints

Web scraping (any public URL)

Charged only when the page comes back with a 2xx status and content. A block, an error page or an empty page is free.

1 (5 with render, 10 premium, 75 both)
  • POST /v1/scrape

Screenshot (any public URL)

PNG, JPEG or WebP, viewport, full page or one element. 5 credits must be available while it runs; x-credits-charged says what was charged. Only a 2xx page that produced an image is charged.

1 (5 for sites that refuse standard requests or with country, 75 premium)
  • GET /v1/screenshot
  • POST /v1/screenshot

Property search / resolve

2
  • POST /v1/search
  • POST /v1/ota/hotels/search
  • POST /v1/ota/agoda/search
  • POST /v1/ota/expedia/search
  • POST /v1/ota/vrbo/search
  • POST /v1/ota/tripadvisor/search

Booking.com property search

4
  • POST /v1/ota/booking/search

Booking.com destination search

Every property Booking.com lists for a place and a stay, with the stay price, review score and stars. An empty answer and a place Booking cannot find are free.

4 per started 25 properties
  • POST /v1/ota/booking/hotels

Name and place lookups

Turn a hotel name, place or ZIP into the id another route takes: a hotel number, stay id, car-rental place or branch, Target store or Domain location. No match is free.

1
  • POST /v1/ota/rakuten/search
  • POST /v1/ota/jalan/search
  • POST /v1/ota/ikyu/search
  • POST /v1/ota/yahoo_travel/search
  • POST /v1/ota/yanolja/search
  • POST /v1/ota/lastminute/search
  • POST /v1/cars/discovercars/locations
  • POST /v1/cars/sixt/locations
  • POST /v1/retail/target/stores
  • POST /v1/domain/locations

Google Hotels destination search

One page is about 20 properties with prices. A page with no properties is free.

4 per page
  • POST /v1/hotels/search
  • POST /v1/serp/google_hotels

Google Hotels calendar

One call returns up to 330 nights per call (90 by default). /v1/calendar adds 3 per night with basis: mainstream and 3 per verify_sources spot-check. POST /v1/jobs bills each succeeded item exactly like POST /v1/calendar, surcharges included (8 for a default item).

8
  • POST /v1/calendar
  • POST /v1/serp/google_hotels_calendar

Google property / rooms / stay

5
  • POST /v1/rooms
  • POST /v1/stay
  • POST /v1/serp/google_hotels_property

Google offers (every seller for one night)

With require_rooms set, a successful call costs 14. Failed calls cost 0.

10 (14 with require_rooms)
  • POST /v1/offers

Single OTA source

Booking.com, Hotels.com, Expedia, Vrbo, Agoda, Airbnb, Tripadvisor, Trivago, ZenHotels, Yanolja, lastminute.com, Hostelworld, Rakuten Travel, Jalan, Ikyu or Yahoo! Travel. An Expedia or Vrbo answer saying the stay can't be sold as asked (a minimum stay, dates taken) is billed: the reason is availability data. Only a reply with nothing in it is free.

12
  • POST /v1/ota/booking
  • POST /v1/ota/booking/rooms
  • POST /v1/ota/hotels
  • POST /v1/ota/hotels/rooms
  • POST /v1/ota/agoda
  • POST /v1/ota/tripadvisor
  • POST /v1/ota/hostelworld
  • POST /v1/ota/rakuten
  • POST /v1/ota/jalan
  • POST /v1/ota/ikyu
  • POST /v1/ota/yahoo_travel
  • POST /v1/ota/trivago
  • POST /v1/ota/zenhotels
  • POST /v1/ota/yanolja
  • POST /v1/ota/lastminute
  • POST /v1/ota/expedia
  • POST /v1/ota/vrbo
  • POST /v1/serp/airbnb
  • GET /api/v1/search?engine=airbnb

Vrbo availability calendar

Day-by-day availability, check-in/check-out rules and minimum stay for up to 12 months is 3; nightly prices (include_prices) or 13-24 months is 5. A Vrbo URL or listing id that has to be looked up adds 24 the first time (pass property_id to skip it). An empty calendar is free.

3 (5 with prices or over 12 months)
  • POST /v1/ota/vrbo/calendar

Airbnb priced calendar

Availability for 1-12 months is 12; each night priced with a real Airbnb quote adds 1 (at most 92, so at most 104 a call). Refused, failed and unsampled nights are free. The SERP-compatible route prices nothing, and costs 12, unless price_nights is set.

12 + 1 per priced night
  • POST /v1/airbnb/calendar
  • POST /v1/serp/airbnb_property_availability_calendar

Official hotel site

50+ official booking engines, detected automatically. The few hotel sites that need more work to read cost 19.

4
  • POST /v1/official

Guest reviews (any source)

Booking.com, Expedia, Hotels.com, Agoda, Airbnb, Vrbo, Trip.com and Google Hotels, plus Trustpilot, G2, Google Play and App Store reviews, 2 for each page fetched (Google Hotels fetches 1-10 pages a call, so 2-20). A page with no reviews is free.

2 per page
  • POST /v1/ota/booking/reviews
  • POST /v1/ota/expedia/reviews
  • POST /v1/ota/hotels/reviews
  • POST /v1/ota/agoda/reviews
  • POST /v1/ota/airbnb/reviews
  • POST /v1/ota/vrbo/reviews
  • POST /v1/ota/tripcom/reviews
  • POST /v1/hotels/reviews
  • POST /v1/trustpilot/reviews
  • POST /v1/g2/reviews
  • POST /v1/app_store/reviews
  • POST /v1/google_play/reviews

Tripadvisor reviews (hotels, restaurants, attractions)

1 for each upstream page of 20 reviews: up to 20 reviews is 1, limit=30 is 2, and bulk (max_reviews) or since_date requests pay per page that returned reviews. A request with no reviews is free.

1 per page of 20
  • POST /v1/ota/tripadvisor/reviews

Tripadvisor details (hotels, restaurants, attractions)

Rating breakdown, sub-ratings, ranking, contact details, hours, amenities and photos for one place. An unknown or ambiguous place is a free 404.

2
  • POST /v1/ota/tripadvisor/details

Google Hotels property lookup

Property details carry the mailing address and phone. Resolve runs one search page plus up to three address lookups (12).

5 details; 12 resolve
  • POST /v1/hotels/property
  • POST /v1/hotels/resolve

Autocomplete, News, Bing, Trends, Amazon search, Walmart search, Indeed

Google Autocomplete, Google News, Bing search, Trends interest and related queries, Amazon and Walmart search, Indeed jobs, Google Play and App Store search and app details, Rightmove, Zoopla and OnTheMarket listings.

2
  • POST /v1/google/autocomplete
  • POST /v1/news
  • POST /v1/bing/search
  • POST /v1/trends/interest
  • POST /v1/trends/related
  • POST /v1/amazon/search
  • POST /v1/walmart/search
  • POST /v1/indeed/jobs
  • POST /v1/google_play/search
  • POST /v1/google_play/app
  • POST /v1/app_store/search
  • POST /v1/app_store/app
  • POST /v1/rightmove/search
  • POST /v1/zoopla/search
  • POST /v1/onthemarket/search

Maps, Google Jobs, Shopping, Images and Videos pages, Domain listings

Google Maps places search and place detail, Google Jobs cards, Google Shopping cards, Google Images and Videos results, Domain.com.au listings.

3
  • POST /v1/maps/search
  • POST /v1/maps/detail
  • POST /v1/jobs/search
  • POST /v1/shopping/search
  • POST /v1/google/images
  • POST /v1/google/videos
  • POST /v1/domain/search

Google web search (organic + PAA + AI Overview)

resolve: true follows each result redirect (billed as part of the same page).

4
  • POST /v1/google/search

Idealo search and offers, TCGplayer search

Idealo price comparison (one page of products with the lowest offer, or one product's per-merchant offers) and one page of TCGplayer marketplace results. An empty answer and an unknown product are free.

13
  • POST /v1/retail/idealo/search
  • POST /v1/retail/idealo/offers
  • POST /v1/retail/tcgplayer/search

Target search

One page of Target products priced at the store you name.

6
  • POST /v1/retail/target/search

Car rental: DiscoverCars

Every supplier's offer DiscoverCars sells at a pick-up place for one rental window. No offers or an unknown place is free.

10
  • POST /v1/cars/discovercars

Car rental: Sixt

Every offer from Sixt's own fleet at one branch for one rental window, with net and tax. No offers or an unknown branch is free.

4
  • POST /v1/cars/sixt

SEC company lookup and filings

A filer's CIK by ticker or name, or its profile and recent filings. No match is free.

1
  • POST /v1/sec/companies
  • POST /v1/sec/filings

SEC financials and full-text search

Revenue, profit, cash flow and balance sheet per year or quarter, or one page of 100 full-text hits. Empty is free.

2
  • POST /v1/sec/financials
  • POST /v1/sec/search

SEC insider trades, fund holdings and private raises

Up to 40 Form 4 filings, one 13F report (with the previous quarter when compared), or up to 50 Form D notices, read and parsed. Empty is free.

4
  • POST /v1/sec/insider_trades
  • POST /v1/sec/holdings
  • POST /v1/sec/private_placements

Earnings calendar

Every company reporting on one day. A day with no reports is free.

2
  • POST /v1/markets/earnings_calendar

Businesses for sale: Empire Flippers

One page of listings for sale or sold. No listing is free.

2
  • POST /v1/businesses_for_sale/empireflippers

Theme-park ticket calendar

Per started 31 days of visit dates (up to 92). include_capacity adds 2 per started 31 days. A calendar with no priced date or an unknown park is free.

4
  • POST /v1/attractions/calendar

eBay search

One page (60) of eBay listings on one of 8 eBay sites. An empty page is free.

8
  • POST /v1/retail/ebay/search

Zalando search

One page (24) of Zalando products on one of 8 country sites. An empty page is free.

5
  • POST /v1/retail/zalando/search

Real estate listings: Zillow, Redfin, Centris

One search page of homes for sale: about 40 on Zillow, up to 350 on Redfin, 20 on Centris. An empty page is free.

2
  • POST /v1/zillow/search
  • POST /v1/redfin/search
  • POST /v1/centris/search

Property detail: Zillow, Redfin, Centris

One listing in full: price, status, facts, description and photos. A listing with no price or address and a removed listing are free.

2
  • POST /v1/zillow/property
  • POST /v1/redfin/property
  • POST /v1/centris/property

StreetEasy NYC rentals and sales

One search page (about 14 rentals or about 38 sales), or one listing, building or agent profile. max_results (up to 200) collects from page 1 and charges 2 credits for each page it fetches. An empty page, a page past the last one, and an unknown record are free. A block before any page is fetched is free. A mid-walk block returns the rows so far with truncated: true and bills pages_fetched.

2 per page or record
  • POST /v1/streeteasy/search
  • POST /v1/streeteasy/listing
  • POST /v1/streeteasy/building
  • POST /v1/streeteasy/agent

Vehicles: AutoTrader, AutoScout24

One search page (25 on AutoTrader, 20 on AutoScout24), or one AutoScout24 listing in full. An empty page, an unknown make or model and a removed listing are free.

2
  • POST /v1/autotrader/search
  • POST /v1/autoscout24/search
  • POST /v1/autoscout24/detail

Event tickets: SeatGeek, Ticketmaster

One page of events; SeatGeek adds live resale prices. A page with no events is free.

2
  • POST /v1/seatgeek/search
  • POST /v1/ticketmaster/search

Event tickets: StubHub

One page (20) of StubHub events with whether each has tickets listed. A page with no events is free.

5
  • POST /v1/stubhub/search

Public events: Facebook

One listing page of public events, or one event in full. An empty page and a missing event are free.

2
  • POST /v1/facebook/events
  • POST /v1/facebook/event

Events: Eventbrite, Luma, Resident Advisor, EventsEye, Songkick, RunSignup, Eventim, Bandsintown, DICE, AllEvents, university calendars

One page of events, one Eventbrite event in full, or one school-year of university dates. An empty page, a missing event and an empty calendar are free.

2
  • POST /v1/events/eventbrite/search
  • POST /v1/events/eventbrite/event
  • POST /v1/events/luma/search
  • POST /v1/events/residentadvisor/search
  • POST /v1/events/tradeshows/search
  • POST /v1/events/songkick/search
  • POST /v1/events/races/search
  • POST /v1/events/eventim/search
  • POST /v1/events/bandsintown/search
  • POST /v1/events/dice/search
  • POST /v1/events/allevents/search
  • POST /v1/events/university/calendar

Events: sports schedules and Live Nation

One league-day of games, or one page of Live Nation AU/NZ/UK events. An empty schedule and an empty page are free.

1
  • POST /v1/events/sports/schedule
  • POST /v1/events/livenation/search

Unified events search

One page from a single provider, chosen with `source`, plus a plain city, dates and category. An empty page is free.

2 (1 for sports and Live Nation)
  • POST /v1/events/search

Etsy search

One search page, 48 listings at limit 48. An empty page is free.

17
  • POST /v1/etsy/search

Classifieds: Craigslist, Kijiji, Karrot

One search page: up to about 350 Craigslist results, a page of Kijiji ads or 60 Karrot products. An empty page is free.

2
  • POST /v1/craigslist/search
  • POST /v1/kijiji/search
  • POST /v1/karrot/search

Target product

One Target product by TCIN, priced at the store you name. An unknown TCIN is free.

3
  • POST /v1/retail/target/product

TCGplayer product

One TCGplayer product's market price per printing. An unknown product is free.

2
  • POST /v1/retail/tcgplayer/product

Shopify store check

Whether an address is a public Shopify store, and whether it is password protected.

1
  • POST /v1/retail/shopify/store/check

Shopify product, inventory, recommendations, product search and suggestions

One product with every variant, its published stock, its related products, or a search of the store's suggest feed. An unknown handle and an empty result are free.

2
  • POST /v1/retail/shopify/products/detail
  • POST /v1/retail/shopify/products/inventory
  • POST /v1/retail/shopify/products/recommendations
  • POST /v1/retail/shopify/products/search
  • POST /v1/retail/shopify/search/suggestions

Shopify products batch

Up to 50 handles in one call. Missing and unreadable handles are free.

2 per product found
  • POST /v1/retail/shopify/products/batch

Shopify product pages (catalog, on sale, new arrivals, best sellers, a collection)

3 for a page of 50 products or fewer (the default limit), 9 for a larger page (up to 250). An empty page is free.

3 or 9
  • POST /v1/retail/shopify/products
  • POST /v1/retail/shopify/products/on-sale
  • POST /v1/retail/shopify/products/new-arrivals
  • POST /v1/retail/shopify/products/best-sellers
  • POST /v1/retail/shopify/collections/products

Shopify store identity, pages, blogs and articles

The store's name, currency and counts, its published pages, and its blogs and articles. An empty list and an unknown handle are free.

3
  • POST /v1/retail/shopify/store
  • POST /v1/retail/shopify/pages
  • POST /v1/retail/shopify/pages/detail
  • POST /v1/retail/shopify/blogs
  • POST /v1/retail/shopify/blogs/articles
  • POST /v1/retail/shopify/blogs/article

Shopify collections

One page of up to 50 published collections. An empty page is free.

4
  • POST /v1/retail/shopify/collections

Shopify sitemap

The locations in the store's sitemap index. An empty sitemap is free.

9
  • POST /v1/retail/shopify/store/sitemap

Shopify catalog stats

Products seen, vendors and the price span across up to 5 catalog pages of 250 (max_pages), so 9-45. An empty scan is free.

9 per page scanned
  • POST /v1/retail/shopify/store/catalog-stats

Shopify product reviews

9 for the product page, plus 2 for each further page of 20 reviews read (the default max_reviews of 50 holds at most 13). No reviews is free.

9 + 2 per further page
  • POST /v1/retail/shopify/products/reviews

Shopify store profile and published contacts

Theme, storefront apps, policy links, menus, and the business emails, phones and social profiles the store publishes.

14
  • POST /v1/retail/shopify/store/profile

Amazon reviews, Walmart reviews

Amazon answers with the product page's ratings histogram and featured reviews; Walmart returns one page (10) of reviews with the summary.

2 per page
  • POST /v1/amazon/reviews
  • POST /v1/walmart/reviews

LinkedIn Jobs search and posting

LinkedIn job cards (up to 10 a page) and one posting by id or link, from LinkedIn's public job pages. An empty page and an unknown id are free.

2
  • POST /v1/linkedin/jobs
  • POST /v1/linkedin/job

FAA aircraft registration

The current FAA record for one N-number. A number with no current registration is free.

2
  • POST /v1/aircraft/registration

FAA aircraft document receipts

Receipts from the last 180 days. An empty window is free.

2
  • POST /v1/aircraft/documents

FAA aircraft registration and receipts

Both records for one N-number in one call.

4
  • POST /v1/aircraft/records

FAA aircraft registry search

One page of up to 100 registry records by owner, manufacturer, model, place or year. A page with no records is free.

2
  • POST /v1/aircraft/search

Upwork jobs search and job detail

One page of up to 10 Upwork jobs, or one job by ciphertext or link. An empty page and an unknown job are free.

2
  • POST /v1/upwork/jobs
  • POST /v1/upwork/job

MarineTraffic vessels

Live AIS positions in the one map tile that contains a point. A tile with vessels is charged. An empty tile is free. A block, an upstream failure, or a tile whose rows cannot be read is HTTP 503 and is free.

2
  • POST /v1/maritime/vessels

CruiseMapper cruises, positions and port

One page of cruises, live positions for up to 10 ships (2 credits per started 10), or one port. An empty page, a ship with no position and an unknown port are free.

2
  • POST /v1/cruisemapper/cruises
  • POST /v1/cruisemapper/positions
  • POST /v1/cruisemapper/port

CruiseMapper ship

One ship in full. An unknown ship is free.

3
  • POST /v1/cruisemapper/ship

1688 search

One page of 1688.com wholesale listings. An empty page is free.

2
  • POST /v1/1688/search

1688 product

One 1688 product in full. A removed listing is free.

10
  • POST /v1/1688/product

ImportYeti search

One page of US import records. An empty page is free.

2
  • POST /v1/importyeti/search

ImportYeti profile

One shipper profile. An unknown company is free.

5
  • POST /v1/importyeti/profile

ImportYeti HS code

One HS code lookup. An unknown code is free.

3
  • POST /v1/importyeti/hs-code

Internet Archive search, item and Wayback

One page of archive.org items, one item with its files, or one URL's Wayback snapshots. An empty page, an unknown item and a URL with no snapshot are free.

2
  • POST /v1/archive/search
  • POST /v1/archive/item
  • POST /v1/archive/wayback

PubMed search and article

One page of full PubMed records, or one article by PMID or link. An empty page and an unknown PMID are free.

2
  • POST /v1/pubmed/search
  • POST /v1/pubmed/article

Zalo Official Account

One public Zalo Official Account. A login-walled or unknown target is free.

2
  • POST /v1/zalo/oa

ThomasNet search and profile

One page of industrial suppliers, or one company profile. An empty page and an unknown company are free.

22
  • POST /v1/thomasnet/search
  • POST /v1/thomasnet/profile

Google Maps business leads

Maps businesses in one place, with emails and social links taken from each business website and an MX check on each address. A partial or empty result is free.

6
  • POST /v1/maps/leads

TikTok video

One public video with its counts, media and music. A missing video is free.

2
  • POST /v1/tiktok/video

TikTok profile

One profile with exact counts and its recent videos. Held at 3 and usually charged 2. A missing account is free.

3
  • POST /v1/tiktok/profile

TikTok search, hashtag and comments

One page of search results, a hashtag with its recent videos, or a video’s comments. An answer with nothing in it is free.

3
  • POST /v1/tiktok/search
  • POST /v1/tiktok/hashtag
  • POST /v1/tiktok/comments

YouTube search, video, transcript, comments, channel

One search page, one video, one transcript, one page of comments or one channel page per call. An empty answer (no results, comments turned off, an empty caption track) and an unknown or private video are free.

2
  • POST /v1/youtube/search
  • POST /v1/youtube/video
  • POST /v1/youtube/transcript
  • POST /v1/youtube/comments
  • POST /v1/youtube/channel

Company careers jobs

The open jobs behind one careers page or job-board URL, read from the company's applicant-tracking system in a single call. A board with no jobs is free.

2
  • POST /v1/careers/jobs

Careers board detection

Which applicant-tracking system and job board a careers page uses, without fetching the jobs.

1
  • POST /v1/careers/detect

Google Play apps and reviews

App listing, app search (about 30 apps) and a page of reviews (up to 200). A page with no reviews is free.

2; reviews 2 per page
  • POST /v1/google_play/app
  • POST /v1/google_play/search
  • POST /v1/google_play/reviews

Apple App Store apps and reviews

App record with its rating histogram, app search (up to 200 apps) and a page of written reviews (up to 20). A page with no reviews is free.

2; reviews 2 per page
  • POST /v1/app_store/app
  • POST /v1/app_store/search
  • POST /v1/app_store/reviews

OTA compare

30
  • POST /v1/ota/compare

Google Flights search and return leg

A search or return-leg call with no results is free.

4
  • POST /v1/serp/google_flights
  • POST /v1/serp/google_flights_return

Google Flights booking options

A booking-options call with no results is free.

5
  • POST /v1/serp/google_flights_booking

Google Flights location search

2
  • POST /v1/serp/google_flights_location_search

Google Flights calendar

6
  • POST /v1/serp/google_flights_calendar

Failed, blocked or empty results; metadata, billing and stored reads

An async job, and a run of an async schedule, is free to submit, poll, list and cancel: each item is charged its own operation's cost as it runs, and failed and cancelled items are free. Empty results include an OTA compare where no source priced, a calendar with no priced nights, a destination-search page with no properties and a flight search with no itineraries. MCP tool calls are priced exactly like the REST call each tool wraps; other MCP messages (initialize, tools/list, ping) cost nothing.

0
  • Any 4xx or 5xx response
  • POST /v1/jobs (items are charged as they succeed)
  • GET /v1/billing
  • GET /v1/billing/ledger
  • GET /v1/billing/plans
  • GET /v1/usage
  • GET /v1/requests
  • GET /v1/requests/{request_id}
  • GET /v1/ota/sources
  • GET /v1/markets
  • GET /v1/attractions/parks
  • GET /v1/datasets
  • GET /v1/datasets/{name}
  • GET /v1/weather/forecast
  • GET /v1/storage/status
  • GET /v1/rates/stored
  • GET /v1/jobs/{job_id}
  • POST /v1/async/jobs (items are charged as they run)
  • GET /v1/async/jobs
  • GET /v1/async/jobs/{job_id}
  • DELETE /v1/async/jobs/{job_id}
  • GET /v1/async/operations
  • POST /v1/async/destinations
  • GET /v1/async/destinations
  • GET /v1/async/destinations/{destination_id}
  • DELETE /v1/async/destinations/{destination_id}
  • POST /v1/async/schedules
  • GET /v1/async/schedules
  • GET /v1/async/schedules/{schedule_id}
  • PUT /v1/async/schedules/{schedule_id}
  • DELETE /v1/async/schedules/{schedule_id}
  • POST /v1/async/schedules/{schedule_id}/run (items are charged as they run)
  • GET /v1/async/callback-secret
  • POST /v1/async/callback-secret/rotate

Calendar surcharges

Two optional POST /v1/calendar settings sample Google's heavier offers pages and cost extra:

  • basis: "mainstream" adds 3 credits per night requested (a 90-night call costs 8 + 270).
  • verify_sources: N (0–5 spot-checks) adds 3 credits per spot-check.

Costs that depend on the request

  • Destination search (POST /v1/hotels/search, POST /v1/serp/google_hotels) costs 4 credits per page of about 20 properties. Each page_token follow-up is a new page and a new charge; a page with no properties is free.
  • Google offers (POST /v1/offers) cost 10 credits (14 with require_rooms). Failed calls cost 0.
  • Airbnb priced calendar (POST /v1/airbnb/calendar) costs 12 credits for the availability calendar plus 1 per night actually priced, at most 92 (so at most 104 a call). The request reserves 12 plus the most nights it could price (max_price_quotes, or 12 for sample and 92 for all) and is charged for the nights priced. Refused, failed and unsampled nights are free. The SERP-compatible route, POST /v1/serp/airbnb_property_availability_calendar, prices nothing by default and costs 12.

MCP tool calls are priced exactly like the REST call each tool wraps (tool table); other MCP messages cost nothing.

The authoritative table is served by GET /v1/billing/plans, so you can read it programmatically.

Credit headers

Every metered response tells you what it cost:

HeaderMeaning
x-credits-charged
Credits charged for this request: the operation cost on success, 0 for failed or empty results.
x-credits-remaining
Credits available on your account after the request. Sent on charged requests.
Response headers
HTTP/2 200
content-type: application/json
x-request-id: req_0123456789abcdef0123456789abcdef
x-credits-charged: 5
x-credits-remaining: 807

The headers are sent for keys linked to a customer account. Free operations (usage, billing, metadata) do not send them.

Plans

Monthly plans, renewed automatically until you cancel:

PlanPrice / monthCredits / monthConcurrent requests
Starter
$49
40,000
10
Growth
$149
150,000
40
Scale
$399
500,000
100
Business
$999
1,500,000
150
Enterprise
Custom
Custom
Custom

Upgrades apply at once and are prorated; downgrades and cancellations take effect at the end of the billing period. See pricing for details, or contact sales for enterprise terms.

Billing endpoints

All three are free and authenticate with your API key.

EndpointReturns
Mode, plan, balance, reserved and available credits, usage this period, period dates.
Every credit movement, newest first. Page with before and next_before.
The plan catalogue and the cost of every operation.
curl "https://api.scrapercompany.com/v1/billing" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY"
GET /v1/billing
{
  "mode": "enforce",
  "plan": {
    "code": "starter",
    "name": "Starter",
    "monthly_credits": 40000,
    "price_usd": 49,
    "concurrency": 10
  },
  "credits": {
    "balance": 39812,
    "reserved": 5,
    "available": 39807,
    "credits_used": 188,
    "credits_refunded": 0,
    "billable_requests": 31
  },
  "period": {
    "start": "2026-10-01T00:00:00+00:00",
    "end": "2026-11-01T00:00:00+00:00"
  }
}
GET /v1/billing/ledger
{
  "entries": [
    {
      "id": 912,
      "kind": "usage",
      "amount": -5,
      "balance_after": 39812,
      "route": "/v1/calendar",
      "request_id": "req_0123456789abcdef0123456789abcdef",
      "detail": {},
      "created_at": "2026-10-14T09:12:44.120000+00:00"
    },
    {
      "id": 3,
      "kind": "grant",
      "amount": 40000,
      "balance_after": 40000,
      "detail": {
        "plan": "starter"
      },
      "created_at": "2026-10-01T00:00:03+00:00"
    }
  ],
  "next_before": null
}

404 from /v1/billing

{"detail": "this API key is not linked to a customer account"} means your key isn't attached to a billing account yet. Email support and we will link it.

Questions about this page?

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

Email support