Places and travel

Each parser reads one kind of page and returns the site’s own data. Send the page’s URL to scrape with a json format that names the parser. The data comes back in data.json.

curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.google.com/maps/search/dentists+in+Ljubljana","formats":[{"type":"json","parser":"google-maps"}]}'

const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.google.com/maps/search/dentists+in+Ljubljana",
    formats: [{ type: "json", parser: "google-maps" }],
  }),
});
console.log(await response.json());

import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.google.com/maps/search/dentists+in+Ljubljana",
        "formats": [{"type": "json", "parser": "google-maps"}],
    },
)
print(response.json())

Send a parser’s options in the same format, like {"type": "json", "parser": "google-maps", "options": {...}}. See Parsers for how they work.

Parser	Reads	Price
`google-maps`	A Google Maps search page that names a place after in, near or around.	1 credit per call.
`google-maps-place`	A Google Maps place page.	1 credit per call.
`google-maps-reviews`	A Google Maps place page.	1 credit per 10 reviews.
`google-flights`	A Google Flights search page, from the address bar or with a q of IATA airport codes and a date, like Flights to JFK from LHR on 2026-12-15.	1 credit per call.
`google-hotels`	A Google Hotels page with a place in q, like hotels in Lisbon.	1 credit per call.
`tripadvisor-search`	A Tripadvisor search page, like tripadvisor.com/Search?q=ritz+london.	1 credit per call.
`tripadvisor-place`	A Tripadvisor hotel, restaurant or attraction page.	1 credit per call.
`tripadvisor-reviews`	A Tripadvisor hotel, restaurant or attraction page.	1 credit per call.
`yelp-search`	A Yelp search page with both what and where, like yelp.com/search?find_desc=pizza&find_loc=Austin%2C+TX.	1 credit per call.
`yelp-business`	A Yelp business page, like yelp.com/biz/franklin-barbecue-austin.	1 credit per call.
`yelp-reviews`	A Yelp business page, like yelp.com/biz/franklin-barbecue-austin.	1 credit per call.
`booking-search`	A Booking.com search results page with a place in ss, like booking.com/searchresults.html?ss=Lisbon.	1 credit per call.
`booking-hotel`	A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html.	1 credit per call.
`booking-reviews`	A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html.	1 credit per call.
`expedia-hotels`	An Expedia hotel search page with a destination, like expedia.com/Hotel-Search?destination=Paris.	1 credit per call.
`airbnb-search`	An Airbnb search page for a place with checkin and checkout dates, like airbnb.com/s/Lisbon—Portugal/homes?checkin=2026-12-10&checkout=2026-12-12.	1 credit per call.
`airbnb-listing`	An Airbnb listing page, like airbnb.com/rooms/18249319.	1 credit per call.
`airbnb-reviews`	An Airbnb listing page, like airbnb.com/rooms/18249319.	1 credit per call.
`luma-events`	A Luma city page, like luma.com/sf or lu.ma/london.	1 credit per call.
`luma-event`	A Luma event page, like luma.com/nighthack.	1 credit per call.

google-maps

A Google Maps search page that names a place after in, near or around.

Example page: https://www.google.com/maps/search/dentists+in+Ljubljana
Returns: A list of places: results, cursor, page, total.
Options: minRating, openNow (Google Maps’ own Hours filter, Open now: only places open at the moment of the search), country (ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted), language (BCP 47 language tag, e.g. en or pt-BR. Any case is accepted), page (Page number, starting at 1).
Price: 1 credit per call. Works without an API key.

Example response

{
  "results": [
    {
      "id": "0x47653296b2abdbc7:0x49588016d0bf3f31",
      "url": "https://www.google.com/maps?cid=5285114998199107377",
      "name": "OrthoDental",
      "categories": [
        "Dentist",
        "Dental clinic",
        "Dental implants periodontist"
      ],
      "address": "Vilharjeva cesta 42, 1000 Ljubljana, Slovenia",
      "location": {
        "latitude": 46.0595907,
        "longitude": 14.5190697
      },
      "phone": "+1 555 0100",
      "website": "https://orthodental.si/",
      "description": null,
      "rating": 4.9,
      "reviewCount": 845,
      "priceLevel": null,
      "hours": [
        {
          "days": "Thursday",
          "times": [
            "7 AM-8 PM"
          ]
        }
      ],
      "images": [
        "https://lh3.googleusercontent.com/grass-cs/AABkmLdBhaKXYHqK_5Aj1bnahBGOIT1sRrAAJnXe3Rmn96rrVp4oGovG0IIlCy2N9ZA74ppszS7_…"
      ],
      "googlePlaceId": "ChIJx9urspYyZUcRMT-_0BaAWEk",
      "photos": 57,
      "hoursToday": "7 AM-8 PM",
      "openStatus": "Closed · Opens 7 AM",
      "timezone": "Europe/Ljubljana",
      "reservationUrl": null,
      "attributes": [
        "Wheelchair accessible entrance",
        "Wheelchair accessible parking lot",
        "Wheelchair accessible restroom"
      ]
    }
  ],
  "cursor": null,
  "page": 1,
  "total": null
}

google-maps-place

A Google Maps place page.

Example page: https://www.google.com/maps/place/Eiffel+Tower/@48.8584,2.2945,17z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0
Returns: One place: id, url, name, categories, address, location, phone, website, description, rating, reviewCount, priceLevel, hours, images.
Options: country (ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted), language (BCP 47 language tag, e.g. en or pt-BR. Any case is accepted).
Price: 1 credit per call.

Example response

{
  "id": "0x47e66e2964e34e2d:0x8ddca9ee380ef7e0",
  "url": "https://www.google.com/maps?cid=10222232094831998944",
  "name": "Eiffel Tower",
  "categories": [
    "Historical landmark",
    "Monument",
    "Tourist attraction"
  ],
  "address": "Av. Gustave Eiffel, 75007 Paris, France",
  "location": {
    "latitude": 48.858370099999995,
    "longitude": 2.2944812999999997
  },
  "phone": null,
  "website": "https://www.toureiffel.paris/fr",
  "description": "Gustave Eiffel's iconic, wrought-iron 1889 tower, with steps and elevators to observation decks.",
  "rating": 4.7,
  "reviewCount": 499973,
  "priceLevel": null,
  "hours": [
    {
      "days": "Thursday",
      "times": [
        "9 AM-12 AM"
      ]
    }
  ],
  "images": [
    "https://lh3.googleusercontent.com/grass-cs/AABkmLdQDdsOsH9WSc8SkiOuMHCC-IdIUZhRh4kDmNWte1b_k3tDK810QX1NVW0k5Y9n5sij1YH8…"
  ],
  "googlePlaceId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "photos": 1717839,
  "hoursToday": "9 AM-12 AM",
  "openStatus": "Closed · Opens 9 AM",
  "timezone": "Europe/Paris",
  "plusCode": "8FW4V75V+8Q",
  "reservationUrl": null,
  "attributes": [
    "Wheelchair accessible entrance",
    "Wheelchair accessible parking lot",
    "Wheelchair accessible restroom"
  ]
}

google-maps-reviews

A Google Maps place page.

Example page: https://www.google.com/maps/place/Eiffel+Tower/@48.8584,2.2945,17z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0
Returns: A list of reviews: results, cursor, page, total.
Options: sort, language (BCP 47 language tag, e.g. en or pt-BR. Any case is accepted), limit (Return at most this many reviews. You pay 1 credit per 10 returned), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per 10 reviews. Works without an API key.

Example response

{
  "results": [
    {
      "id": "Ci9DQUlRQUNvZENodHljRjlvT21SdFFpMWllVlYwUVZwbVVHUjJVbHBCVmpOamRFRRAB",
      "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21SdFFpMWllVlYwUVZwbVVHUjJVbHBCVm…",
      "author": {
        "id": "114431275563417848290",
        "name": "Abubakir Sldlql",
        "handle": null,
        "url": "https://www.google.com/maps/contrib/114431275563417848290/reviews?hl=en-GB",
        "avatarUrl": "https://lh3.googleusercontent.com/a/ACg8ocKzoJXQl9O1IxdAdtfYqMW_JdPWQfI2LoIvi3whGl1YpN33qQ=s64-c-rp-mo-br100"
      },
      "rating": 1,
      "title": null,
      "text": null,
      "publishedAt": "2026-11-04T22:13:17.846Z",
      "likes": null,
      "response": null,
      "subject": null,
      "language": null,
      "authorReviews": 0,
      "authorPhotos": 0,
      "authorIsLocalGuide": false,
      "imageUrls": [],
      "details": []
    }
  ],
  "cursor": "Ci8IARInCgoAP72F5XxPbG__EhB-y9zFqnuTEO83mU0AAAAAGgf_Al5XxPbGGAAiAA",
  "page": null,
  "total": null
}

google-flights

A Google Flights search page, from the address bar or with a q of IATA airport codes and a date, like Flights to JFK from LHR on 2026-12-15.

Example page: https://www.google.com/travel/flights?q=Flights%20to%20JFK%20from%20LHR%20on%202026-12-15
Returns: isBest, price, priceCurrency, airlines, stops, durationSeconds.
Options: returnDate, adults, cabin, currency (ISO 4217 currency code, e.g. USD), stops (Google Flights’ Stops filter), airlines (Google Flights’ Airlines filter, as airline codes like KQ or EK), carryOnBags (Google Flights’ Bags filter: prices include this many carry-on bags), checkedBags (Google Flights’ Bags filter: prices include this many checked bags), maxPrice (Google Flights’ Price filter, in currency for all adults), departureTime (Google Flights’ Times filter for the outbound departure), arrivalTime (Google Flights’ Times filter for the outbound arrival), maxDurationHours (Google Flights’ Duration filter).
Price: 1 credit per call.

Example response

{
  "cabin": "economy",
  "tripType": "oneWay",
  "adults": 1,
  "url": "https://www.google.com/travel/flights/search?tfs=GhoSCjIwMjYtMTItMTVqBRIDTEhScgUSA0pGS0ABSAGYAQI%3D&tfu=EgQIABABIgA&hl=…",
  "results": [
    {
      "isBest": true,
      "price": 406,
      "priceCurrency": "USD",
      "airlines": [
        "SWISS"
      ],
      "stops": 1,
      "durationSeconds": 44100,
      "departureLocalTime": "2026-12-15T06:00",
      "arrivalLocalTime": "2026-12-15T13:15",
      "legs": [
        {
          "flightNumber": "LX 345",
          "airline": "SWISS",
          "originCode": "LHR",
          "originName": "Heathrow Airport",
          "destinationCode": "ZRH",
          "destinationName": "Zurich Airport",
          "departureLocalTime": "2026-12-15T06:00",
          "arrivalLocalTime": "2026-12-15T08:40",
          "durationSeconds": 6000,
          "aircraft": "Airbus A320neo",
          "legroom": "29 inches"
        }
      ],
      "layovers": [
        {
          "airport": "ZRH",
          "name": "Zurich Airport",
          "city": "Zürich",
          "durationSeconds": 4500
        }
      ],
      "emissionsGrams": 381000,
      "typicalEmissionsGrams": 346000
    }
  ]
}

google-hotels

A Google Hotels page with a place in q, like hotels in Lisbon.

Example page: https://www.google.com/travel/search?q=hotels%20in%20Lisbon
Returns: name, hotelId, hotelUrl, price, totalPrice, priceCurrency.
Options: checkIn (Defaults to tomorrow), checkOut (Defaults to one night after checkIn), adults, childrenAges (One age per child, like [7, 12]), currency (ISO 4217 currency code, e.g. USD), minPrice (Per night), maxPrice (Per night), minRating (Google Hotels’ own Guest rating), hotelClass (Google Hotels’ own Hotel class, as star counts like [4, 5]), amenities (Google Hotels’ own Amenities. Every one must be offered), propertyTypes (Google Hotels’ own Property type), freeCancellation, specialOffers, sort, cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "checkIn": "2026-11-05",
  "checkOut": "2026-11-06",
  "results": [
    {
      "name": "Lisboa Pessoa Hotel",
      "hotelId": "ChoIh4uhruDksvGAARoNL2cvMTFjMXMzZHQ5dBAB",
      "hotelUrl": "https://www.google.com/travel/hotels/entity/ChoIh4uhruDksvGAARoNL2cvMTFjMXMzZHQ5dBAB?hl=en&gl=us&curr=USD&ts=CAESCgoCCA…",
      "price": 130,
      "totalPrice": 142,
      "priceCurrency": "USD",
      "deal": "GREAT DEAL",
      "dealDescription": "39% less than usual",
      "rating": 4.7,
      "reviews": 1545,
      "hotelClass": 4,
      "amenities": [
        "Breakfast ($)",
        "Free Wi-Fi",
        "Parking ($)"
      ],
      "position": 1
    }
  ],
  "cursor": "eyJvZmZzZXQiOjE4LCJzZWVuIjpbIkNob0loNHVocnVEa3N2R0FBUm9OTDJjdk1URmpNWE16WkhRNWRCQUIiLCJDaGtJNjhtUXRLaW9ncElfR2cwdlp5OHhNV051WWpONWRIRXdFQUUiLCJDaG9JN1pTN2pib..."
}

tripadvisor-search

A Tripadvisor search page, like tripadvisor.com/Search?q=ritz+london.

Example page: https://www.tripadvisor.com/Search?q=ritz+london&ssrc=h
Returns: A list of places: results, cursor, page, total.
Options: location.
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "187591",
      "url": "https://www.tripadvisor.com/Hotel_Review-g186338-d187591-Reviews-The_Ritz_London_Hotel-London_England.html",
      "name": "The Ritz London Hotel",
      "categories": [
        "accommodation"
      ],
      "address": "150 Piccadilly",
      "location": {
        "latitude": 51.507088,
        "longitude": -0.141628
      },
      "phone": null,
      "website": null,
      "description": null,
      "rating": null,
      "reviewCount": null,
      "priceLevel": null,
      "hours": [],
      "images": [
        "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/33/be/ef/d4/the-ritz-london-entrance.jpg?w=1200&h=900&s=1"
      ],
      "type": "accommodation",
      "parent": "London, England"
    }
  ],
  "cursor": null,
  "page": null,
  "total": null
}

tripadvisor-place

A Tripadvisor hotel, restaurant or attraction page.

Example page: https://www.tripadvisor.com/Hotel_Review-g186338-d187591-Reviews-The_Ritz_London_Hotel-London_England.html
Returns: One place: id, url, name, categories, address, location, phone, website, description, rating, reviewCount, priceLevel, hours, images.
Price: 1 credit per call.

Example response

null

tripadvisor-reviews

A Tripadvisor hotel, restaurant or attraction page.

Example page: https://www.tripadvisor.com/Hotel_Review-g186338-d187591-Reviews-The_Ritz_London_Hotel-London_England.html
Returns: A list of reviews: results, cursor, page, total.
Options: language, ratings, travelerTypes (Tripadvisor’s own Traveler type filter: families, couples, solo, business or friends. Only reviews from these travelers), months (Tripadvisor’s own Time of year filter: marMay, junAug, sepNov or decFeb. Only reviews written in these months of the year), sort (Tripadvisor’s own Sort by: mostRecent (Most recent) or detailed (Detailed reviews, ordered by recency and how much they say)), page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "1082705333",
      "url": "https://www.tripadvisor.com/ShowUserReviews-g186338-d187591-r1082705333-The_Ritz_London_Hotel-London_England.html",
      "author": {
        "id": null,
        "name": "Richard P",
        "handle": "G5474DTrichardk",
        "url": "https://www.tripadvisor.com/Profile/G5474DTrichardk",
        "avatarUrl": null
      },
      "rating": 5,
      "title": "Great place",
      "text": "Brilliant everything doorman super cool receptionist  bit  moody",
      "publishedAt": "2026-10-21T00:00:00.000Z",
      "likes": 0,
      "response": {
        "text": "Dear G5474DTrichardk,\n\nWe are delighted to read that you enjoyed your experience with us. However, we are sorry to…",
        "publishedAt": "2026-10-22T00:00:00.000Z"
      },
      "subject": {
        "id": "187591",
        "name": "The Ritz London Hotel",
        "url": "https://www.tripadvisor.com/Hotel_Review-g186338-d187591-Reviews-The_Ritz_London_Hotel-London_England.html"
      },
      "ownerReplyAuthor": "General Manager",
      "language": "en",
      "stayMonth": "2026-10",
      "tripType": "friends",
      "subRatings": [
        {
          "name": "Value",
          "rating": 3
        }
      ],
      "authorAddress": "Sotogrande, Spain",
      "authorContributions": 88
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 4965
}

yelp-search

A Yelp search page with both what and where, like yelp.com/search?find_desc=pizza&find_loc=Austin%2C+TX.

Example page: https://www.yelp.com/search?find_desc=plumber&find_loc=Austin%2C+TX
Returns: A list of places: results, cursor, page, total.
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "TVHztfQAJUIaJDgdJuke-g",
      "url": "https://www.yelp.com/biz/blue-dragon-plumbing-austin-2",
      "name": "Blue Dragon Plumbing",
      "categories": [
        "Plumbing"
      ],
      "address": "Austin",
      "location": null,
      "phone": null,
      "website": null,
      "description": null,
      "rating": 4.9,
      "reviewCount": 532,
      "priceLevel": null,
      "hours": [],
      "images": [],
      "businessAlias": "blue-dragon-plumbing-austin-2",
      "addressStreet": null,
      "addressCity": "Austin"
    }
  ],
  "cursor": null,
  "page": null,
  "total": null
}

yelp-business

A Yelp business page, like yelp.com/biz/franklin-barbecue-austin.

Example page: https://www.yelp.com/biz/franklin-barbecue-austin
Returns: One place: id, url, name, categories, address, location, phone, website, description, rating, reviewCount, priceLevel, hours, images.
Price: 1 credit per call.

Example response

{
  "id": "MGzro82Fi4LYvc86acoONQ",
  "url": "https://www.yelp.com/biz/franklin-barbecue-austin",
  "name": "Franklin Barbecue",
  "categories": [
    "Barbeque"
  ],
  "address": "900 E 11th St, Austin, TX 78702",
  "location": {
    "latitude": 30.2701348,
    "longitude": -97.73134511
  },
  "phone": "+1 555 0100",
  "website": "https://franklinbbq.com",
  "description": null,
  "rating": 4.5,
  "reviewCount": 6495,
  "priceLevel": "$$$",
  "hours": [
    {
      "days": "Mon",
      "times": [
        "Closed"
      ]
    }
  ],
  "images": [],
  "businessAlias": "franklin-barbecue-austin",
  "addressStreet": "900 E 11th St",
  "addressCity": "Austin",
  "addressRegion": "TX",
  "addressPostalCode": "78702",
  "addressCountry": "US",
  "neighborhoods": [
    "East Austin"
  ],
  "photosAndVideos": 8635,
  "isClaimed": true
}

yelp-reviews

A Yelp business page, like yelp.com/biz/franklin-barbecue-austin.

Example page: https://www.yelp.com/biz/franklin-barbecue-austin?sort_by=date_desc
Returns: A list of reviews: results, cursor, page, total.
Options: page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "Wtxnb99DEKuOQtZ9Yd5qTw",
      "url": "https://www.yelp.com/biz/franklin-barbecue-austin?hrid=Wtxnb99DEKuOQtZ9Yd5qTw",
      "author": {
        "id": "pOeu-5wB-A8kRcjJ1SWrdw",
        "name": "Jen I.",
        "handle": null,
        "url": "https://www.yelp.com/user_details?userid=pOeu-5wB-A8kRcjJ1SWrdw",
        "avatarUrl": null
      },
      "rating": 5,
      "title": null,
      "text": "This was a bucket list resteraunt for us to try, we had some extra time and were in town so we had to try it out. \n\nWe…",
      "publishedAt": "2026-11-02T20:42:12.000Z",
      "likes": null,
      "response": null,
      "subject": {
        "id": "MGzro82Fi4LYvc86acoONQ",
        "name": "Franklin Barbecue",
        "url": "https://www.yelp.com/biz/franklin-barbecue-austin"
      },
      "language": "en",
      "authorReviews": 115
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 6480
}

booking-search

A Booking.com search results page with a place in ss, like booking.com/searchresults.html?ss=Lisbon.

Example page: https://www.booking.com/searchresults.html?ss=Lisbon&checkin=2026-12-10&checkout=2026-12-12&group_adults=2&no_rooms=1
Returns: A list of listings: results, cursor, page, total.
Options: currency (ISO 4217 currency code, e.g. USD), sort (Booking.com’s own Sort by: relevance (Our top picks) or distance (closest to the center of the place first)), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "9098389",
      "url": "https://www.booking.com/hotel/pt/eurostas-lisboa-baixa.html",
      "title": "Eurostars Lisboa Baixa",
      "description": null,
      "price": {
        "amount": 131.75,
        "currency": "USD"
      },
      "pricePeriod": "night",
      "status": null,
      "address": "Rua de Prata, 88-114",
      "location": {
        "latitude": 38.710131,
        "longitude": -9.136478
      },
      "bedrooms": null,
      "bathrooms": null,
      "area": null,
      "propertyType": null,
      "rating": 4.6,
      "reviewCount": 1834,
      "images": [
        "https://cf.bstatic.com/xdata/images/hotel/square600/425895275.jpg?k=eb4c9000683d7cdc25d9ecd4d321a30c9560b3a6183dde24632…"
      ],
      "host": null,
      "position": 1,
      "stars": 4,
      "city": "Lisboa",
      "countryCode": "pt",
      "distanceText": "0.3 miles from downtown",
      "hasFreeCancellation": false,
      "neighborhood": "Santa Maria Maior, Lisbon",
      "nights": 2,
      "totalPrice": {
        "amount": 263.5,
        "currency": "USD"
      },
      "taxesAndFees": {
        "amount": 33.79,
        "currency": "USD"
      },
      "originalPrice": {
        "amount": 439.16,
        "currency": "USD"
      }
    }
  ],
  "cursor": "eyJvZmZzZXQiOjI1LCJzZWVuIjpbOTA5ODM4OSwyMzY3NjcsMzkzODIsMjM3NTAxLDQ5NjgyLDI4MzcyNTEsMzE1NDQyLDE0MDQ5MzQ2LDM5ODMzLDE5NzQ5MzcsMzc0NzU2NSwxMDQ0NTAxLDQxNzQ4MCw5O...",
  "page": null,
  "total": 3772,
  "place": "Lisbon",
  "checkIn": "2026-12-10",
  "checkOut": "2026-12-12"
}

booking-hotel

A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html.

Example page: https://www.booking.com/hotel/pt/hf-fenix-urban.html
Returns: One listing: id, url, title, description, price, pricePeriod, status, address, location, bedrooms, bathrooms, area, propertyType, rating, reviewCount, images, host.
Price: 1 credit per call.

Example response

{
  "id": "179501",
  "url": "https://www.booking.com/hotel/pt/hf-fenix-urban.html",
  "title": "HF Fénix Urban",
  "description": "Centrally located in Lisbon, the HF Fénix Urban is a modern 4-star nonsmoking hotel offering free Wi-Fi and…",
  "price": null,
  "pricePeriod": "night",
  "status": null,
  "address": "Avenida Antonio Augusto De Aguiar,14, Avenidas Novas, 1050-016 Lisbon, Portugal",
  "location": {
    "latitude": 38.7287525576462,
    "longitude": -9.149000197649
  },
  "bedrooms": null,
  "bathrooms": null,
  "area": null,
  "propertyType": "hotel",
  "rating": 4.35,
  "reviewCount": 2463,
  "images": [
    "https://cf.bstatic.com/xdata/images/hotel/max1024x768/351732850.jpg?k=dbeeb7b9acf72e3c4be78fc36c2fa5eb12c3d3ee0012a27bc…",
    "https://cf.bstatic.com/xdata/images/hotel/max1024x768/778806252.jpg?k=3325ffa8f65107252c89e6b8f2d8d215a2867cdc4ffb2df98…",
    "https://cf.bstatic.com/xdata/images/hotel/max1024x768/814912825.jpg?k=81eab4c647a17b920393c7ae8c7eaed47015e36e1214e32ae…"
  ],
  "host": null,
  "stars": 4,
  "addressStreet": "Avenida Antonio Augusto De Aguiar,14",
  "addressCity": "Lisbon",
  "addressCountryCode": "pt",
  "checkInFrom": "3:00 PM",
  "checkOutUntil": "12:00 PM",
  "facilities": [
    {
      "group": "General",
      "name": "Air conditioning"
    }
  ],
  "rooms": [
    {
      "roomId": "17950102",
      "name": "Comfort Queen",
      "sizeSquareMeters": 12,
      "description": "Located between the 1st and 12th floor, this comfort room features a white modern décor, flat-screen TV and mini-bar.…"
    }
  ],
  "scores": [
    {
      "category": "Staff",
      "rating": 4.5
    }
  ]
}

booking-reviews

A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html.

Example page: https://www.booking.com/hotel/pt/hf-fenix-urban.html
Returns: A list of reviews: results, cursor, page, total.
Options: sort (Booking.com’s own Sort reviews by: newest, mostRelevant or lowestScore (lowest scores first). Only newest pages without gaps. The other orders change between requests, so a walk through the pages can miss reviews), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "2af60057e6609d9a",
      "url": null,
      "author": null,
      "rating": 5,
      "title": null,
      "text": "La ubicación y la cercanía del medio de trasporte",
      "publishedAt": "2026-11-04T13:15:43.000Z",
      "likes": null,
      "response": null,
      "subject": {
        "id": "179501",
        "name": null,
        "url": null
      },
      "language": "es",
      "travelerType": "Couple",
      "authorCountryCode": "es",
      "roomName": "Economy Double or Twin Room",
      "nights": 3,
      "checkIn": "2026-10-31",
      "checkOut": "2026-11-03",
      "positiveText": "La ubicación y la cercanía del medio de trasporte",
      "negativeText": null
    }
  ],
  "cursor": "eyJvZmZzZXQiOjI1LCJzZWVuIjpbIjJhZjYwMDU3ZTYiLCI0ZjViYWQ4MmVlIiwiNDdiZjQ0ZGU5ZSIsIjZmZmRmOWYwMzQiLCIyZDcyOTBjZGJiIiwiODJhNzM0MDU4MCIsIjg4NTM1ODBlNzYiLCJhZDU4M...",
  "page": null,
  "total": 2463
}

expedia-hotels

An Expedia hotel search page with a destination, like expedia.com/Hotel-Search?destination=Paris.

Example page: https://www.expedia.com/Hotel-Search?destination=Paris&startDate=2026-12-10&endDate=2026-12-12&adults=2
Returns: A list of listings: results, cursor, page, total.
Options: sort (Expedia’s own sort: relevance (Recommended), priceLow (lowest price first) or rating (guest rating)), page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "9619719",
      "url": "https://www.expedia.com/Paris-Hotels-Hotel-De-Roubaix.h9619719.Hotel-Information?chkin=2026-12-10&chkout=2026-12-12&rm1…",
      "title": "Hotel de Roubaix",
      "description": null,
      "price": {
        "amount": 193,
        "currency": "USD"
      },
      "pricePeriod": "night",
      "status": null,
      "address": null,
      "location": null,
      "bedrooms": null,
      "bathrooms": null,
      "area": null,
      "propertyType": null,
      "rating": 4.7,
      "reviewCount": 1581,
      "images": [
        "https://images.trvl-media.com/lodging/10000000/9620000/9619800/9619719/7f5c6c38.jpg?impolicy=resizecrop&ra=fit&rw=455&r…"
      ],
      "host": null,
      "neighborhood": "Paris",
      "ratingText": "Exceptional",
      "totalPrice": {
        "amount": 438,
        "currency": "USD"
      },
      "totalPriceBefore": {
        "amount": 564,
        "currency": "USD"
      }
    }
  ],
  "cursor": null,
  "page": null,
  "total": 482
}

airbnb-search

An Airbnb search page for a place with checkin and checkout dates, like airbnb.com/s/Lisbon—Portugal/homes?checkin=2026-12-10&checkout=2026-12-12.

Example page: https://www.airbnb.com/s/Lisbon—Portugal/homes?checkin=2026-12-10&checkout=2026-12-12&adults=2
Returns: A list of listings: results, cursor, page, total.
Options: minPrice (Airbnb’s own price range minimum: the nightly price after discounts and before taxes, in currency), maxPrice (Airbnb’s own price range maximum: the nightly price after discounts and before taxes, in currency), roomType (Airbnb’s own Type of place filter: entireHome (Entire home) or privateRoom (Room)), currency (Currency of every price in the answer and of minPrice and maxPrice), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "635404000587905839",
      "url": "https://www.airbnb.com/rooms/635404000587905839",
      "title": "Standard Studio with AC and Private bathroom",
      "description": null,
      "price": {
        "amount": 68.36,
        "currency": "USD"
      },
      "pricePeriod": "night",
      "status": null,
      "address": "Lisbon",
      "location": {
        "latitude": 38.7193,
        "longitude": -9.1572
      },
      "bedrooms": null,
      "bathrooms": null,
      "area": null,
      "propertyType": "Apartment",
      "rating": 4.92,
      "reviewCount": 350,
      "images": [
        "https://a0.muscache.com/im/pictures/miso/Hosting-635404000587905839/original/3131351e-96cc-4756-b74c-f644f5151efe.jpeg",
        "https://a0.muscache.com/im/pictures/miso/Hosting-635404000587905839/original/4a866961-2a6a-4cdd-9bde-dbe3fa76be06.jpeg",
        "https://a0.muscache.com/im/pictures/miso/Hosting-635404000587905839/original/65558c53-5aee-4d4d-8e4e-d7872c2e81bb.jpeg"
      ],
      "host": null,
      "badges": [
        "Guest favorite"
      ],
      "totalPrice": {
        "amount": 154.66,
        "currency": "USD"
      },
      "priceBeforeDiscount": {
        "amount": 170.64,
        "currency": "USD"
      }
    }
  ],
  "cursor": "eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxOCwidmVyc2lvbiI6MX0=~82f73074-e148-48f7-b3a3-d0c1f5fefc9e~1793832342_EAMmM5MDBmNjE4Zm~4tsfx44wwpwv.csstjkeoah...",
  "page": null,
  "total": null,
  "location": "Lisbon, Portugal"
}

airbnb-listing

An Airbnb listing page, like airbnb.com/rooms/18249319.

Example page: https://www.airbnb.com/rooms/18249319
Returns: One listing: id, url, title, description, price, pricePeriod, status, address, location, bedrooms, bathrooms, area, propertyType, rating, reviewCount, images, host.
Options: checkIn (First night, as YYYY-MM-DD. Send it with checkOut to get the price), checkOut (Day you leave, as YYYY-MM-DD. Send it with checkIn to get the price), guests (Number of guests. Only stays that fit this many), currency (Currency of every price in the answer and of minPrice and maxPrice).
Price: 1 credit per call.

Example response

{
  "id": "18249319",
  "url": "https://www.airbnb.com/rooms/18249319",
  "title": "Boutique Flat Cris do Carmo",
  "description": "Located in the trendy, buzzing, and historic neighborhood of Chiado, this one-bedroom flat is both cozy and stylish,…",
  "price": null,
  "pricePeriod": "night",
  "status": null,
  "address": "Lisbon, Portugal",
  "location": {
    "latitude": 38.71345,
    "longitude": -9.14014
  },
  "bedrooms": 1,
  "bathrooms": 1,
  "area": null,
  "propertyType": "Entire rental unit",
  "rating": 4.88,
  "reviewCount": 432,
  "images": [
    "https://a0.muscache.com/im/pictures/502c9731-ade7-4661-ad6b-bf8d7f11a039.jpg",
    "https://a0.muscache.com/im/pictures/1cfb830e-c5a2-4653-aa4e-7763183827f5.jpg",
    "https://a0.muscache.com/im/pictures/36e150aa-079b-4732-b616-da4e48256e15.jpg"
  ],
  "host": {
    "id": null,
    "name": "GestHomes By Alexandra & Pedro",
    "handle": null,
    "url": null,
    "avatarUrl": null,
    "isSuperhost": true
  },
  "guests": 2,
  "beds": 2,
  "amenities": [
    "Hair dryer",
    "Cleaning products",
    "Shampoo"
  ],
  "isGuestFavorite": true,
  "ratingAccuracy": 4.87,
  "ratingCheckin": 4.88,
  "ratingCleanliness": 4.92,
  "ratingCommunication": 4.92,
  "ratingLocation": 4.96,
  "ratingValue": 4.78,
  "houseRules": [
    "Up to 2 overnight guests",
    "No pets",
    "No smoking: Including vaping and e-cigarettes"
  ],
  "isAvailable": null,
  "totalPrice": null,
  "priceBeforeDiscount": null
}

airbnb-reviews

An Airbnb listing page, like airbnb.com/rooms/18249319.

Example page: https://www.airbnb.com/rooms/18249319
Returns: A list of reviews: results, cursor, page, total.
Options: page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "1807210451071666201",
      "url": null,
      "author": {
        "id": null,
        "name": "Magali",
        "handle": null,
        "url": null,
        "avatarUrl": null
      },
      "rating": 5,
      "title": null,
      "text": "Logement très agréable, très propre avec tous les équipements nécessaires pour les courts séjours. Literie et linge de…",
      "publishedAt": "2026-10-29T11:24:33.000Z",
      "likes": null,
      "response": {
        "text": "Merci beaucoup, Magali, pour ce retour élogieux ! Nous sommes ravis que vous ayez apprécié le confort et la propreté…",
        "publishedAt": null
      },
      "subject": {
        "id": "18249319",
        "name": null,
        "url": "https://www.airbnb.com/rooms/18249319"
      },
      "language": "fr",
      "translatedText": "Very nice accommodation, very clean with all the amenities needed for short stays. Spotless bedding and linens.\nIdeal…",
      "stayNote": "Stayed a few nights"
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 432
}

luma-events

A Luma city page, like luma.com/sf or lu.ma/london.

Example page: https://luma.com/sf
Returns: A list of events: results, cursor, page, total.
Options: category (Only events in this Luma category), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "evt-Wh9NlYi9GwQqF2J",
      "url": "https://luma.com/wkt3e8lq",
      "title": "FORWARD - WOMEN'S HEALTH SUMMIT",
      "description": null,
      "startsAt": "2026-11-04T17:30:00.000Z",
      "endsAt": "2026-11-04T23:30:00.000Z",
      "timezone": "America/Los_Angeles",
      "isOnline": false,
      "address": "SVB Experience Center, 532 Market St, San Francisco, CA 94104, USA",
      "location": {
        "latitude": 37.7905863,
        "longitude": -122.40033319999998
      },
      "price": null,
      "hosts": [
        {
          "id": null,
          "name": "TechThrive Ventures",
          "handle": null,
          "url": null,
          "avatarUrl": null
        }
      ],
      "images": [
        "https://images.lumacdn.com/uploads/02/e46677f2-8725-4293-8f29-9ffa8c66520b.jpg"
      ],
      "city": "San Francisco, CA",
      "calendarName": "Personal",
      "guestCount": 0,
      "isFree": true,
      "isSoldOut": true,
      "spotsRemaining": 0,
      "needsApproval": true,
      "hasWaitlist": true
    }
  ],
  "cursor": "eyJzdiI6IjIwMjYtMTEtMDUgMDE6MzA6MDArMDAiLCJmYiI6ImV2dC1aRHVxZ2lVMzdrcDRCWnAifQ",
  "page": null,
  "total": null,
  "city": "San Francisco"
}

luma-event

A Luma event page, like luma.com/nighthack.

Example page: https://luma.com/nighthack
Returns: One event: id, url, title, description, startsAt, endsAt, timezone, isOnline, address, location, price, hosts, images.
Price: 1 credit per call.

Example response

{
  "id": "evt-BQrIrfoOg0genkv",
  "url": "https://luma.com/nighthack",
  "title": "Night Hack by Founders, Inc.",
  "description": "Night Hack is back at Founders, Inc. on October 30.\n\nCome make something you want to show off. A robot. An agent. A…",
  "startsAt": "2026-10-30T23:00:00.000Z",
  "endsAt": "2026-10-31T06:00:00.000Z",
  "timezone": "America/Los_Angeles",
  "isOnline": false,
  "address": null,
  "location": {
    "latitude": 37.80902842340874,
    "longitude": -122.43129988976843
  },
  "price": null,
  "hosts": [
    {
      "id": null,
      "name": "Adrianna Lakatos",
      "handle": null,
      "url": null,
      "avatarUrl": null
    }
  ],
  "images": [
    "https://images.lumacdn.com/event-covers/r1/24ead38c-7d9b-48bf-a3ff-24e7a74c0398.png"
  ],
  "city": "San Francisco, CA",
  "calendarName": "Founders, Inc. Events",
  "guestCount": 399,
  "isFree": true,
  "isSoldOut": false,
  "spotsRemaining": 51,
  "needsApproval": true,
  "hasWaitlist": false,
  "categories": [
    "AI"
  ],
  "ticketTypes": [
    {
      "name": "Builder",
      "price": null,
      "currency": null,
      "needsApproval": true
    }
  ]
}

Get started

Parsers

Guides

Plans and billing

Places and travel

google-maps

google-maps-place

google-maps-reviews

google-flights

google-hotels

tripadvisor-search

tripadvisor-place

tripadvisor-reviews

yelp-search

yelp-business

yelp-reviews

booking-search

booking-hotel

booking-reviews

expedia-hotels

airbnb-search

airbnb-listing

airbnb-reviews

luma-events

luma-event

​google-maps

​google-maps-place

​google-maps-reviews

​google-flights

​google-hotels

​tripadvisor-search

​tripadvisor-place

​tripadvisor-reviews

​yelp-search

​yelp-business

​yelp-reviews

​booking-search

​booking-hotel

​booking-reviews

​expedia-hotels

​airbnb-search

​airbnb-listing

​airbnb-reviews

​luma-events

​luma-event

google-maps

google-maps-place

google-maps-reviews

google-flights

google-hotels

tripadvisor-search

tripadvisor-place

tripadvisor-reviews

yelp-search

yelp-business

yelp-reviews

booking-search

booking-hotel

booking-reviews

expedia-hotels

airbnb-search

airbnb-listing

airbnb-reviews

luma-events

luma-event