API reference
Every endpoint, generated from the OpenAPI spec: parameters, examples, responses and errors.
All endpoints live under https://api.scrapercompany.com, take and return JSON, and authenticate with the x-api-key header. Each page lists parameters, a copy-paste example in cURL, Python and Node.js, a real response with field descriptions, and the errors that endpoint can return. The pages are generated from the OpenAPI document (openapi.json · openapi.yaml), so they always match it.
Discovery
Turn a hotel name into the property token the Google endpoints use.
Google Hotels
Destination search, nightly calendars, stay prices, per-seller offers and room types.
- POST
/v1/calendarCalendarPrice a forward horizon in one call5+ credits - POST
/v1/stayStayPrice one explicit stay window3 credits - POST
/v1/offersOffersPer-OTA offers for one night3 credits - POST
/v1/roomsRoom matrixRoom types by OTA, aligned on one signature3 credits - POST
/v1/hotels/searchDestination searchSearch a destination for hotels and prices3 credits
Booking.com
Name search, calendar and rooms from Booking.com.
Hotels.com
Name search, prices and rooms from Hotels.com.
Expedia
Name search, then rooms and rate plans for one stay from Expedia.
Agoda
Name search and rooms from Agoda.
Tripadvisor
Metasearch offers from Tripadvisor.
Hostelworld
Dorms and private rooms from Hostelworld.
Airbnb
Vacation-rental search in SearchAPI shape, and a day-by-day calendar with quoted prices.
- POST
/v1/serp/airbnbAirbnb searchAirbnb search, SearchAPI-compatible8 credits - GET
/api/v1/searchAirbnb search (GET)SearchAPI GET alias for engine=airbnb8 credits - POST
/v1/airbnb/calendarAirbnb priced calendarPriced Airbnb nightly calendar8+ credits - POST
/v1/serp/airbnb_property_availability_calendarAirbnb availability calendar (SearchAPI)Airbnb availability calendar, SearchAPI-compatible, with prices8+ credits
Vrbo
Vacation-rental search and stay quotes from Vrbo.
Google Flights
Itineraries, return and multi-city legs, booking options, airport lookup and date-grid fares, in SearchAPI / SerpApi shape.
- POST
/v1/serp/google_flightsGoogle Flights searchGoogle Flights search for itineraries3 credits - POST
/v1/serp/google_flights_returnReturn and next-leg flightsGoogle Flights return or next-leg options3 credits - POST
/v1/serp/google_flights_bookingFlight booking optionsGoogle Flights booking options for an itinerary3 credits - POST
/v1/serp/google_flights_location_searchFlight location searchResolve a city or airport to IATA codes1 credit - POST
/v1/serp/google_flights_calendarGoogle Flights calendarGoogle Flights date-grid pricing5 credits
Cross-source
Rate parity across OTAs and the source capability matrix.
Official site
The hotel's own booking engine, 31 engines supported.
SearchAPI compatible
Drop-in Google Hotels search, property and calendar shapes.
- POST
/v1/serp/google_hotelsGoogle Hotels search (SearchAPI)google_hotels destination search, drop-in3 credits - POST
/v1/serp/google_hotels_propertyGoogle Hotels property (SearchAPI)google_hotels_property, drop-in3 credits - POST
/v1/serp/google_hotels_calendarGoogle Hotels calendar (SearchAPI)Horizon sweep in SearchAPI's parameter style5 credits
Guest reviews
Guest reviews from Tripadvisor, Booking.com, Expedia, Hotels.com and Google Hotels, with provenance per page.
- POST
/v1/hotels/reviewsGoogle Hotels reviewsGuest reviews, aggregated by provider2 credits - POST
/v1/ota/expedia/reviewsExpedia reviewsGuest reviews for one property, newest first2 credits - POST
/v1/ota/hotels/reviewsHotels.com reviewsGuest reviews for one property, newest first2 credits - POST
/v1/ota/tripadvisor/reviewsTripadvisor reviewsGuest reviews, newest first as the site orders them2 credits - POST
/v1/ota/booking/reviewsBooking.com reviewsGuest reviews from the property page's own query document2 credits
Property lookup
Confirm a property by its mailing address before targeting it.
Google News
Keyword search and section headlines from Google's own RSS wire.
Google Search
Organic results, People Also Ask and the AI Overview, rendered.
Bing
Organic results with trackers decoded to destination URLs.
Google Trends
Interest over time and top/rising related queries.
Google Maps
Places search and place detail with review counts.
Google Jobs
Job cards with apply sources, rendered.
Google Shopping
Product cards with price, merchant and condition.
Amazon
Product search and a product's ratings histogram with featured reviews.
Walmart
Product search and reviews from the store's own JSON, over plain HTTP.
Indeed
Job records with salary, posting age and company ratings, over plain HTTP.
Jobs
Asynchronous calendar batches with webhooks.
Stored rates
Read stored observations without calling a source.
Usage
Usage totals and request history for your key.
Billing
Plan, credit balance, ledger and the cost table.