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

// Airbnb documentation

Airbnb Search API

Search Airbnb stays by destination or map bounds, dates, guests, price, amenities, accessibility and booking filters.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/airbnb/search

// from request to code

Integrate Airbnb Search

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

APIAirbnb Search
More options 23
Stay search

Search Airbnb stays by destination or map bounds, dates, guests, price, amenities, accessibility and booking filters.

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://ecll-litescrape-v3--site-api-web.modal.run/api/airbnb/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "q": "Austin, TX",
  "adults": 2,
  "amenities": "wifi",
  "instant_book": false,
  "self_check_in": false,
  "guest_favorite": false,
  "luxe": false,
  "page": 1
}'

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/airbnb/search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "q": "Austin, TX",
  "adults": 2,
  "amenities": "wifi",
  "page": 1
}

// request reference

Airbnb Search parameters

Send query parameters with GET /api/airbnb/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 v3 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 search

Search Airbnb stays by destination or map bounds, dates, guests, price, amenities, accessibility and booking filters.

q
QOptional

Destination, address, or landmark.

Type string · GET query or POST JSON

  • Maximum characters: 500
map_bounds
Map boundsOptional

North,east,south,west map coordinates.

Type string · GET query or POST JSON

airbnb_domain
Airbnb domainOptional

Airbnb localization domain.

Type string · GET query or POST JSON · Default airbnb.com

currency
CurrencyOptional

Currency code for returned prices.

Type string · GET query or POST JSON

check_in_date
Check in dateOptional

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

Type string · GET query or POST JSON

check_out_date
Check out dateOptional

Check-out date, later than check-in.

Type string · GET query or POST JSON

adults
AdultsOptional

Number of guests aged 13 or above.

Type integer · GET query or POST JSON

  • Minimum: 0
children
ChildrenOptional

Number of guests aged 2 to 12.

Type integer · GET query or POST JSON

  • Minimum: 0
infants
InfantsOptional

Number of guests under 2.

Type integer · GET query or POST JSON

  • Minimum: 0
pets
PetsOptional

Number of pets.

Type integer · GET query or POST JSON

  • Minimum: 0
room_type
Room typeOptional

Type of place.

Type string · GET query or POST JSON

Accepted valuesentire_homeprivate_room
min_price
Min priceOptional

Minimum total trip price including fees.

Type number · GET query or POST JSON

  • Minimum: 0
max_price
Max priceOptional

Maximum total trip price including fees.

Type number · GET query or POST JSON

  • Minimum: 0
bedrooms
BedroomsOptional

Minimum bedrooms.

Type integer · GET query or POST JSON

  • Minimum: 0
beds
BedsOptional

Minimum beds.

Type integer · GET query or POST JSON

  • Minimum: 0
bathrooms
BathroomsOptional

Minimum bathrooms.

Type number · GET query or POST JSON

  • Minimum: 0
property_types
Property typesOptional

Comma-separated property types.

Type string · GET query or POST JSON

amenities
AmenitiesOptional

Comma-separated required amenities.

Type string · GET query or POST JSON

accessibility_features
Accessibility featuresOptional

Comma-separated accessibility features.

Type string · GET query or POST JSON

host_languages
Host languagesOptional

Comma-separated host language codes.

Type string · GET query or POST JSON

instant_book
Instant bookOptional

Require instant booking.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse
self_check_in
Self check inOptional

Require self check-in.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse
guest_favorite
Guest favoriteOptional

Only Guest favorites.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse
luxe
LuxeOptional

Only Airbnb Luxe places.

Type boolean · GET query or POST JSON · Default false

Accepted valuestruefalse
page
PageOptional

Results page, from 1 to 15.

Type integer · GET query or POST JSON · Default 1

  • Minimum: 1
  • Maximum: 15

// 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_metadata, search_parameters, organic_results, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

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

200 · application/json
{
  "search_metadata": {
    "id": "b98864364faba6decfe9105a",
    "status": "Success",
    "airbnb_url": "https://www.airbnb.com/s/homes?query=Austin%2C+TX",
    "total_time_taken": 1.382
  },
  "search_parameters": {
    "q": "Austin, TX",
    "airbnb_domain": "airbnb.com",
    "instant_book": false,
    "self_check_in": false,
    "guest_favorite": false,
    "luxe": false,
    "page": 1
  },
  "organic_results": [
    {
      "position": 1,
      "property_id": "1674771563375922164",
      "name": "Pool, Hot Tub, Huge Theater, Mini Golf, Sleeps 19",
      "type": "Home in Pflugerville",
      "description": "Pool, hot tub, theater, and mini golf",
      "link": "https://airbnb.com/rooms/1674771563375922164?check_in=2026-10-25&check_out=2026-10-30",
      "check_in_date": "2026-10-25",
      "check_out_date": "2026-10-30",
      "badges": [
        "Guest favorite"
      ],
      "images": [
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/fd1508ad-7348-4a9f-ba3b-ec135a2ed0e3.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/c31d05ee-e19c-4203-9da9-6b640aea5df1.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/ba39ec7b-5ce9-4b6e-95fb-12aaae239660.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/a578ec21-7ab4-4ad7-8d5e-d885268408df.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/5e0bbd2a-e85f-4912-b154-c429686c28eb.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/8226cd00-38ca-4b08-b3ba-9a34e729a5ce.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/9cd41bb1-d550-41ef-b2d3-6ce9555eb6df.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/21741884-58f1-45cb-b644-72975d461fc8.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/7977c8f8-30b6-4ec0-a81e-c00ab9becdb6.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/2ba0b4cc-ff79-471e-bf54-10af4059427a.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/06b28e23-5e69-49dd-9fc2-0b0999bd10c9.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/0f8d7c0a-d677-45a3-8a2d-50c2228bff90.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/a4ee329e-a8bd-45f4-af91-e43de48eef9b.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/44020f54-dc90-4a85-b626-3e1361330da6.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/936ccdda-44c0-47b1-b558-3ec3c7d592ac.jpeg",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/82371b52-7354-45ab-aa64-ff5f60870787.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/b9913ceb-678c-4a17-8f0a-47c5f9c43039.jpeg",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/5c54482f-2fd8-47bb-9e09-6aa328a4c889.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/9c0fb6a2-f32c-406f-b9a8-926e657f8929.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/a6cd3d14-c55d-4ab7-9410-ebea83d9b527.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/6d89d77a-dffd-4f1e-9753-c36a21918727.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/e86079aa-fe84-408b-a405-e70fa5efc613.jpeg",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/463b0ca0-7a9a-40fe-a1cb-79880ac01324.jpeg",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/4e4c97fe-3234-4275-89c7-b784346fd845.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/4ca9a907-e831-4191-bcf8-101ce2db0502.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/7d3b6a53-1cb4-4f99-a488-fdd635ffa935.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/1843ee3b-52aa-46c5-bcb2-a9ec8f0d2768.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/8aeda60a-21b7-4711-a422-072454877bd1.png",
        "https://a0.muscache.com/im/pictures/hosting/Hosting-1674771563375922164/original/c65ef877-6e12-4531-8a4b-35873ab5854e.png"
      ],
      "price": {
        "accessibilityLabel": "$3,060 for 5 nights",
        "price": "$3,060",
        "qualifier": "for 5 nights",
        "concatQualifierLeft": false,
        "trailing": null
      },
      "price_breakdown": {
        "title": "Price details",
        "subtitle": null,
        "priceDetails": [
          {
            "items": [
              {
                "description": "5 nights x $612.00",
                "priceString": "$3,060.00",
                "explanationData": null
              }
            ],
            "renderBorderTop": false,
            "collapsable": null
          }
        ]
      },
      "rooms_and_beds": [
        "4 bedrooms",
        "9 beds",
        "3.5 baths"
      ],
      "rating": 5,
      "reviews": 38,
      "gps_coordinates": {
        "latitude": 30.43351,
        "longitude": -97.61443
      }
    }
  ],
  "pagination": {
    "next": "https://api.litescrape.com/api/airbnb/search?q=Austin%2C+TX&airbnb_domain=airbnb.com&instant_book=False&self_check_in=False&guest_favorite=False&luxe=False&page=2"
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}