Airbnb Total Stay Price API - Dated Pricing and Explanations

Supply listingId, checkinDate and checkoutDate; use future YYYY-MM-DD dates with checkout after check-in. Keep guest composition and currencyCode aligned with the search being compared. The live selected-listing response returned status:true, message:Successful and data of type StayPDPSections with three sectionContainer entries containing booking-price and cancellation-policy information. structuredDisplayPrice included a rounded stay headline and explanationData price items with more precise priceString amounts. Do not multiply a rounded nightly label or treat the headline as a guaranteed final booking total. displayTotalPrice is documented as including fees before taxes; this GET request does not book a stay.

API Features

Required dated stay quote Tie the pricing request to one listing and an explicit check-in/check-out window.

Headline-to-explanation reconciliation Compare rounded primary-line display prices with the precise amounts in their explanation items.

Section-based price information The observed dated response used price and cancellation sections rather than a single numeric price field.

Before-tax display semantics The documented displayTotalPrice flag includes fees before taxes and does not establish a final charge guarantee.

Live API Demo

GET /api/project/airbnb-search/stays-price-detail

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-price-detail?key=<API_KEY>&listingId=1173047051903832695&checkinDate=<checkinDate>&checkoutDate=<checkoutDate>&adults=2&currencyCode=USD&languageCode=en-US'

curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-price-detail?key=<API_KEY>&listingId=1173047051903832695&checkinDate=<checkinDate>&checkoutDate=<checkoutDate>&adults=2&currencyCode=USD&languageCode=en-US'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Compare a selected stay across alternative future trip windows with the same guest counts and currency.
Explain a rounded stay headline alongside its more precise quoted explanation amount in a comparison interface.
Capture timestamped dated quotes for comparable-listing research without labeling them historical transactions.
Review returned cancellation information together with the observed date-specific price before opening the original listing.

Frequently asked questions

Why can a price headline differ slightly from an explanation amount?

The live five-night example showed a rounded whole-unit headline and a more precise explanation amount for the same stay. Read structuredDisplayPrice.explanationData instead of multiplying a rounded nightly display or treating rounding as conflicting quotes.

Does displayTotalPrice include taxes or create a reservation?

It is documented as including fees before taxes. This is a read-only price request: it does not reserve inventory, charge a traveler or guarantee a later booking total.

Related operations

Guides

View Subscription Plans →

Get a Date-Specific Airbnb Stay Price Breakdown