Name: Airbnb Search API: stay prices for exact dates and guests
Brand: benthepythondev
SKU: api-benthepythondev-airbnb-scraper
Availability: InStock
Author: API Market

# Airbnb Search Prices API

## Overview

The Airbnb Search Prices API searches Airbnb for a place, exact stay dates and guest counts, and returns the listings as JSON. One endpoint takes the destination, check-in and check-out dates, adults, children, infants, pets and a display currency, and returns each listing's ID and link, title and name, total stay price with the price breakdown, rating and review count, coordinates, photos and badges.

It is built for short-term rental investors and analysts, property managers pricing their own listings, travel apps comparing stays, and AI trip planners. Results are limited to listings that match the requested stay (`matches_requested_stay`), and the API can follow Airbnb's result pages up to 15 pages deep.

## Features

*   **1 endpoint**: search Airbnb by place, dates and guests.
*   **Total stay price**: `total_price`, the display string and the price breakdown with fees.
*   **Listing details**: ID, link, title, rating, review count, coordinates, photos and badges.
*   **Exact stays**: results match the dates and guest counts you send.
*   **Up to 20 results**: per request, following up to 15 result pages.
*   **Rate limit**: 1 request per second on the Free plan.

## Use Cases

*   **Rental market research**: compare prices for the same dates across a city.
*   **Dynamic pricing**: benchmark your listing against nearby stays.
*   **Travel apps**: show Airbnb options with total prices.
*   **AI trip planners**: answer stay questions with real prices.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/benthepythondev/airbnb-scraper
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Airbnb Scraper

Export Airbnb listings for exact stay dates and guest counts with room IDs, property IDs, total prices, fees, ratings and public page cursors. Up to 20 results per request, as JSON.

**Method:** `POST`

**Endpoint:** `/`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| location | body | Place name passed to Airbnb search; source may include nearby areas. | string | No | Berlin, Germany | - |
| checkIn | body | Exact YYYY-MM-DD arrival date. Supply with checkOut; omitting both selects a two-night stay starting seven days from now. | string | No | - | - |
| checkOut | body | Exact YYYY-MM-DD departure date; supply with checkIn for a stay of 1..365 nights. | string | No | - | - |
| adults | body | Requested adults; alternative guest-count suggestions are excluded. | integer | No | 2 | 16 |
| children | body | Requested children. | integer | No | 0 | 10 |
| infants | body | Requested infants. | integer | No | 0 | 5 |
| pets | body | Requested pets. | integer | No | 0 | 5 |
| currency | body | Display currency requested from Airbnb. Original display strings and total qualifiers are preserved. | string | No | EUR | - |
| maxPages | body | Follow public source cursors, up to 15 pages. A request returns 20 rows at most. | integer | No | 2 | 15 |
| maxResults | body | Upper bound on unique listing IDs for the requested stay. | integer | No | 30 | 300 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/benthepythondev/airbnb-scraper/' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"location": "Lisbon, Portugal", "checkIn": "2027-03-10", "checkOut": "2027-03-13", "adults": 2, "currency": "USD", "maxResults": 10}'
```

**Example Response (201 Created, trimmed):**

Long lists are cut to their first items and long text is shortened.

```json
[
  {
    "listing_id": "38283736",
    "property_id": null,
    "source_location": "Lisbon, Portugal",
    "url": "https://www.airbnb.com/rooms/38283736?check_in=2027-03-10&check_out=2027-03-13&adults=2&children=0&infants=0&pets=0&currency=USD",
    "title": "Apartment in Lisbon",
    "subtitle": "Renovated 18th-century flat with private balcony",
    "name": "New Flat with Balcony in the heart of Old Lisbon",
    "price_display": "$579",
    "price_qualifier": "for 3 nights",
    "total_price": 579,
    "price_accessibility_label": "$579 for 3 nights",
    "price_breakdown": {
      "__typename": "DisplayPriceExplanationData",
      "title": "Price details",
      "subtitle": null,
      "priceDetails": [
        {
          "__typename": "DisplayPriceExplanationLineGroup",
          "items": [
            {
              "__typename": "DefaultExplanationLineItem",
              "description": "3 nights x $192.93",
              "priceString": "$578.80",
              "explanationData": null
            }
          ],
          "renderBorderTop": false,
          "collapsable": null
        }
      ]
    },
    "currency": "USD",
    "check_in": "2027-03-10",
    "check_out": "2027-03-13",
    "adults": 2,
    "children": 0,
    "infants": 0,
    "pets": 0,
    "rating": 4.95,
    "review_count": 339,
    "coordinates": {
      "__typename": "Coordinate",
      "latitude": 38.7094,
      "longitude": -9.1385
    },
    "image_urls": [
      "https://a0.muscache.com/im/pictures/54953b8a-a288-40ad-8c2d-cc9ae4db8366.jpg",
      "https://a0.muscache.com/im/pictures/07dc6541-0a7f-475f-ab89-5d8c65267a36.jpg"
    ],
    "badges": [
      "Guest favorite"
    ],
    "matches_requested_stay": true,
    "search_url": "https://www.airbnb.com/s/Lisbon--Portugal/homes?checkin=2027-03-10&checkout=2027-03-13&adults=2&children=0&infants=0&pets=0&currency=USD&query=Lisbon%2C+Portugal",
    "location_query": "Lisbon, Portugal",
    "source_page": 1,
    "scraped_at": "2026-10-27T06:50:50.269890+00:00"
  },
  {
    "listing_id": "13376882",
    "property_id": null,
    "source_location": "Lisbon, Portugal",
    "url": "https://www.airbnb.com/rooms/13376882?check_in=2027-03-10&check_out=2027-03-13&adults=2&children=0&infants=0&pets=0&currency=USD",
    "title": "Apartment in Lisbon",
    "subtitle": "Vintage sewing-themed studio on a quiet street",
    "name": "Romantic Cozy studio in the heart of Lisbon.",
    "price_display": "$249",
    "price_qualifier": "for 3 nights",
    "total_price": 249,
    "price_accessibility_label": "$249 for 3 nights, originally $282",
    "price_breakdown": {
      "__typename": "DisplayPriceExplanationData",
      "title": "Price details",
      "subtitle": null,
      "priceDetails": [
        {
          "__typename": "DisplayPriceExplanationLineGroup",
          "items": [
            {
              "__typename": "DiscountedExplanationLineItem",
              "description": "3 nights x $82.69",
              "priceString": "$248.06",
              "originalPriceString": "$281.99",
              "explanationData": null
            }
          ],
          "renderBorderTop": false,
          "collapsable": null
        },
        {
          "__typename": "DisplayPriceExplanationDisclaimer",
          "content": "João recently lowered the price for these dates (from the average rate for the past 60 nights)."
        }
      ]
    },
    "currency": "USD",
    "check_in": "2027-03-10",
    "check_out": "2027-03-13",
    "adults": 2,
    "children": 0,
    "infants": 0,
    "pets": 0,
    "rating": 4.85,
    "review_count": 337,
    "coordinates": {
      "__typename": "Coordinate",
      "latitude": 38.7188,
      "longitude": -9.1576
    },
    "image_urls": [
      "https://a0.muscache.com/im/pictures/miso/Hosting-13376882/original/442392d1-9c9c-47bd-9390-c28529b5cb11.jpeg",
      "https://a0.muscache.com/im/pictures/miso/Hosting-13376882/original/0c5f4cbe-6dd8-4419-9ea5-fc635b146b0c.jpeg"
    ],
    "badges": [
      "Guest favorite"
    ],
    "matches_requested_stay": true,
    "search_url": "https://www.airbnb.com/s/Lisbon--Portugal/homes?checkin=2027-03-10&checkout=2027-03-13&adults=2&children=0&infants=0&pets=0&currency=USD&query=Lisbon%2C+Portugal",
    "location_query": "Lisbon, Portugal",
    "source_page": 1,
    "scraped_at": "2026-10-27T06:50:50.357750+00:00"
  }
]
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 201 | Created | The request ran and the body holds the results. |
| 400 | Bad Request | The body is not valid JSON, a date is not in YYYY-MM-DD format, or a guest count is out of range. |
| 401 | Unauthorized | The `x-api-market-key` header is missing, invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path, or the item you asked for, does not exist. |
| 429 | Too Many Requests | You sent more than 1 request per second, or you used all 50 calls of the Free plan. |
| 500 | Internal Server Error | Something failed on the provider side. Retry after a short delay. |
| 503 | Service Unavailable | The service or its data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

You can send up to 1 request per second. Free includes 50 calls (a 7-day trial), Pro includes 1,500 calls a month for $9.99, Ultra includes 12,000 calls a month for $29.99 and Mega includes 50,000 calls a month for $99.99. Requests above the limit return `429 Too Many Requests`; throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **What if I leave out the dates?**
    The API searches a two-night stay starting seven days from today. Send both `checkIn` and `checkOut` for exact dates.

*   **Is `total_price` per night?**
    No. It is the total for the stay; `price_qualifier` says how many nights, for example "for 3 nights".

*   **Which currencies are supported?**
    `EUR`, `USD` and `GBP`, set with `currency`.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Search Airbnb listings by place, check-in, check-out and guest count. JSON with room IDs, total price incl. fees, rating and reviews. No login.

Airbnb Search API: stay prices for exact dates and guests

Free

benthepythondev

Ultra

Mega

Search Airbnb by place, stay dates and guests. Get room IDs, total stay price with fees, rating, reviews and photos as JSON, up to 20 listings per call.