## airbnb/search-stays

`GET /v1/airbnb/search-stays`

Stays in a place for a trip: name, city, room type, rating and review count, position, the nightly price and the trip total as the site shows them, photos, instant booking and the host with their rating and years hosting. Pages by cursor.

*Airbnb stay search*

| Parameter | Required | Description |
| --- | --- | --- |
| `location` | no | A city, area or address; resolved to a place once and remembered (or pass place_id) — e.g. `Lisbon` |
| `place_id` | no | A place id from airbnb/locations |
| `checkin` | no | Check-in date, YYYY-MM-DD (with checkout) — e.g. `2026-10-10` |
| `checkout` | no | Check-out date, YYYY-MM-DD (with checkin) — e.g. `2026-10-14` |
| `adults` | no | Adults, up to 16 — e.g. `2` |
| `children` | no | Children, up to 15 |
| `infants` | no | Infants, up to 5 |
| `pets` | no | Pets, up to 5 |
| `min_price` | no | Minimum price per night in the currency |
| `max_price` | no | Maximum price per night in the currency |
| `type_of_place` | no | The site's type-of-place filter |
| `property_type` | no | The site's property-type filter |
| `bedrooms` | no | Minimum bedrooms |
| `beds` | no | Minimum beds |
| `bathrooms` | no | Minimum bathrooms |
| `amenities` | no | The site's amenity ids, separated by commas |
| `booking_options` | no | The site's booking-option filters |
| `host_language` | no | The site's host-language filter |
| `top_tier` | no | The site's top-tier-stays filter |
| `total_price` | no | Show the trip total instead of the nightly price — e.g. `false` |
| `limit` | no | Results per page, 1 to 50 — e.g. `16` |
| `cursor` | no | The cursor from the previous page |
| `currency` | no | Three-letter currency code — e.g. `GBP` |
| `language` | no | Language code for the site's text |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 11 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/airbnb/search-stays" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "badges": [
        "example"
      ],
      "city": "example",
      "id": "example",
      "image_url": "https://example.com/example",
      "images": [
        "example"
      ],
      "latitude": 0,
      "longitude": 0,
      "name": "example",
      "notes": [
        "example"
      ],
      "platform": "example",
      "price": {
        "accessibility_label": "example",
        "amount": 0,
        "label": "example",
        "original_amount": 0,
        "original_label": "example",
        "qualifier": "example"
      },
      "price_breakdown": [
        {}
      ],
      "rating": 0,
      "reviews": 0,
      "subtitle": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "place": {
    "id": "example",
    "name": "example"
  }
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/airbnb/search-stays#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/airbnb/search-stays.json)