Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Booking.com documentation

Booking.com Search API

Search accommodations by destination and stay, with locations, prices, rate terms, ratings, and room configurations.

GET / POST https://api.litescrape.com/api/booking/search

For background execution, use POST /api/booking/search/async. Learn how to submit and poll async requests →

// from request to code

Integrate Booking.com Search

Build your request and copy it into your stack. Or let your coding agent set it up.

APIBooking.com Search
More options 7
Stay and destination
Language and pagination

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://api.litescrape.com/api/booking/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "checkin": "2027-01-14",
  "checkout": "2027-01-17",
  "adults": 2,
  "rooms": 1,
  "currency": "EUR",
  "language": "en-us",
  "destination": "London",
  "page": 1,
  "limit": 2
}'

JSON POST request example

POST to https://api.litescrape.com/api/booking/search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "checkin": "2027-01-14",
  "checkout": "2027-01-17",
  "adults": 2,
  "rooms": 1,
  "currency": "EUR",
  "language": "en-us",
  "destination": "London",
  "page": 1,
  "limit": 2
}

// request reference

Booking.com Search parameters

Send query parameters with GET /api/booking/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the Litescrape OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Stay and destination

checkin
Check-inRequired

Check-in date in YYYY-MM-DD format.

Type string · GET query or POST JSON

Example / input hint: 2027-01-14

  • Pattern: ^\d{4}-\d{2}-\d{2}$
checkout
Check-outRequired

Check-out date in YYYY-MM-DD format.

Type string · GET query or POST JSON

Example / input hint: 2027-01-16

  • Check-out must be later than check-in, with a stay of at most 30 nights.
  • Pattern: ^\d{4}-\d{2}-\d{2}$
adults
AdultsOptional

Number of adults.

Type integer · GET query or POST JSON · Default 2

Example / input hint: 2

  • Minimum: 1
  • Maximum: 30
children
Children agesOptional

Comma-separated ages of children, from 0 to 17.

Type string · GET query or POST JSON

Example / input hint: 4,9

  • Include one age for each child, with at most 10 children.
  • Maximum characters: 100
rooms
RoomsOptional

Number of rooms.

Type integer · GET query or POST JSON · Default 1

Example / input hint: 1

  • Minimum: 1
  • Maximum: 30
currency
CurrencyOptional

Currency for accommodation prices.

Type string · GET query or POST JSON · Default USD

Example / input hint: USD

Accepted valuesAUDBRLCADCHFCNYCZKDKKEURGBPHKDHUFINRJPYKRWMXNNOKNZDPLNRONSEKSGDTHBTRYUSDZAR
destination
DestinationRequired

Destination name, region, or property search term.

Type string · GET query or POST JSON

Example / input hint: Paris

  • Use the city, region, or property name accepted by Booking.com.
  • Minimum characters: 1
  • Maximum characters: 200

Language and pagination

language
LanguageOptional

Language for accommodation results.

Type string · GET query or POST JSON · Default en-us

Example / input hint: en-us

Accepted valuesen-usen-gbde-dees-esfr-frit-itnl-nlpt-brja-jpko-krpl-plru-rutr-trzh-cn
page
PageOptional

Results page to retrieve.

Type integer · GET query or POST JSON · Default 1

Example / input hint: 1

  • Use pagination.next_page when present. A null pagination.has_more means another page was not confirmed.
  • Minimum: 1
  • Maximum: 10
limit
LimitOptional

Maximum accommodations to return from this page.

Type integer · GET query or POST JSON · Default 25

Example / input hint: 25

  • Use limit=25 to retrieve every item on each page.
  • Minimum: 1
  • Maximum: 25

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_parameters, accommodations, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "search_parameters": {
    "checkin": "2027-01-14",
    "checkout": "2027-01-17",
    "adults": 2,
    "children": null,
    "rooms": 1,
    "currency": "EUR",
    "language": "en-us",
    "destination": "London",
    "page": 1,
    "limit": 2
  },
  "accommodations": [
    {
      "property_id": "426368",
      "name": "ibis London Blackfriars",
      "url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html",
      "image_url": "https://cf.bstatic.com/xdata/images/hotel/square240/889077857.jpg?k=a2b895c41f025e91a44fc8eac89a95290f2c38dee3e73ec9e486d2ae1169e1a2&o=",
      "location": "49 Blackfriars Road",
      "latitude": 51.5051831716537,
      "longitude": null,
      "district": "Southwark, London",
      "distance_from_center": "1 miles from downtown",
      "public_transport_distance": "Southwark station is within 150 yards",
      "location_score": null,
      "rate_terms": {
        "free_cancellation": true,
        "cancellation_deadline": "2027-01-13T00:00:00Z",
        "cancellation_text": null,
        "no_prepayment": true,
        "prepayment_text": null,
        "meal_plan": null
      },
      "room_types": [
        {
          "room_id": "42636801",
          "name": "Standard Double Room",
          "size": null,
          "size_unit": null,
          "capacity": null,
          "beds": [
            {
              "type_id": 6,
              "description": null,
              "count": 1
            }
          ],
          "facilities": [],
          "image_urls": []
        }
      ],
      "rating": 8.3,
      "review_count": 6475,
      "room_type": "Standard Double Room",
      "availability": "available",
      "price": {
        "total": 305,
        "currency": "EUR",
        "price_per_night": 101.763099464583,
        "price_before_discount": 407.052397858334,
        "discounts": [
          {
            "name": "Late Escape Deal",
            "amount": 101.763099464583,
            "currency": "EUR"
          }
        ],
        "tax_breakdown": [
          {
            "name": null,
            "type_id": 21,
            "amount": 61.0578596787501,
            "currency": "EUR",
            "included": true
          }
        ],
        "taxes_and_fees": 61.0578596787501,
        "taxes_and_fees_included": false,
        "completeness": "total"
      },
      "booking_url": "https://www.booking.com/hotel/gb/ibis-london-blackfriars.html?checkin=2027-01-14&checkout=2027-01-17&group_adults=2&no_rooms=1&group_children=0&selected_currency=EUR&lang=en-us"
    },
    {
      "property_id": "178835",
      "name": "Montcalm Mayfair, Autograph Collection",
      "url": "https://www.booking.com/hotel/gb/the-montcalm.html",
      "image_url": "https://cf.bstatic.com/xdata/images/hotel/square240/861319655.jpg?k=5c8eeaad40eb47947f2140d45c4f404140ce2baa540a45c465c212701e3b6a7b&o=",
      "location": "2, Wallenberg Place",
      "latitude": 51.51524236,
      "longitude": null,
      "district": "Hyde Park",
      "distance_from_center": "1.5 miles from downtown",
      "public_transport_distance": "Marble Arch station is within 200 yards",
      "location_score": 9.4,
      "rate_terms": {
        "free_cancellation": false,
        "cancellation_deadline": null,
        "cancellation_text": null,
        "no_prepayment": false,
        "prepayment_text": null,
        "meal_plan": null
      },
      "room_types": [
        {
          "room_id": "17883554",
          "name": "Studio",
          "size": null,
          "size_unit": null,
          "capacity": null,
          "beds": [
            {
              "type_id": 3,
              "description": null,
              "count": 1
            }
          ],
          "facilities": [],
          "image_urls": []
        }
      ],
      "rating": 8.7,
      "review_count": 201,
      "room_type": "Studio",
      "availability": "unknown",
      "price": {
        "total": 975,
        "currency": "EUR",
        "price_per_night": 306.706160779494,
        "price_before_discount": null,
        "discounts": [],
        "tax_breakdown": [
          {
            "name": null,
            "type_id": 21,
            "amount": 184.023648461517,
            "currency": "EUR",
            "included": true
          }
        ],
        "taxes_and_fees": 184.023648461517,
        "taxes_and_fees_included": false,
        "completeness": "unknown"
      },
      "booking_url": "https://www.booking.com/hotel/gb/the-montcalm.html?checkin=2027-01-14&checkout=2027-01-17&group_adults=2&no_rooms=1&group_children=0&selected_currency=EUR&lang=en-us"
    }
  ],
  "pagination": {
    "page": 1,
    "has_more": true,
    "next_page": 2,
    "returned_count": 2
  },
  "submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}

More Booking.com APIs