> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape an Airbnb listing's full details

> Fetches one Airbnb stay (by listing id or room URL) and returns it as JSON: `title`, `description`, `roomType`, `propertyType`, `location` (city, country, `lat`/`lng`), `host` (name, `isSuperhost`, `responseRate`, `yearsHosting`, photo), `rating` (overall plus accuracy, cleanliness, check-in, communication, location, value), `reviewsCount`, `guests`, `bedrooms`, `beds`, `bathrooms`, grouped `amenities`, `photos` with captions, `highlights`, `houseRules`, `checkIn`/`checkOut` times and `isGuestFavorite`. Add `check_in`/`check_out` for `available`, the `cancellationPolicy` and `price` (total, nightly, breakdown) in `currency`; add `include_reviews` for up to `max_reviews` guest `reviews`. Companion to the Airbnb search plugin (`/travel/airbnb`).



## OpenAPI

````yaml /api-reference/openapi.json post /travel/airbnb-room
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /travel/airbnb-room:
    post:
      tags:
        - Plugins
      summary: Scrape an Airbnb listing's full details
      description: >-
        Fetches one Airbnb stay (by listing id or room URL) and returns it as
        JSON: `title`, `description`, `roomType`, `propertyType`, `location`
        (city, country, `lat`/`lng`), `host` (name, `isSuperhost`,
        `responseRate`, `yearsHosting`, photo), `rating` (overall plus accuracy,
        cleanliness, check-in, communication, location, value), `reviewsCount`,
        `guests`, `bedrooms`, `beds`, `bathrooms`, grouped `amenities`, `photos`
        with captions, `highlights`, `houseRules`, `checkIn`/`checkOut` times
        and `isGuestFavorite`. Add `check_in`/`check_out` for `available`, the
        `cancellationPolicy` and `price` (total, nightly, breakdown) in
        `currency`; add `include_reviews` for up to `max_reviews` guest
        `reviews`. Companion to the Airbnb search plugin (`/travel/airbnb`).
      operationId: airbnb_room_travel_airbnb_room_post
      parameters:
        - name: room
          in: query
          required: true
          schema:
            type: string
            description: >-
              Airbnb listing id (e.g. 23860926) or a room URL on any Airbnb
              domain, e.g. 'https://www.airbnb.co.uk/rooms/23860926'.
            title: Room
          description: >-
            Airbnb listing id (e.g. 23860926) or a room URL on any Airbnb
            domain, e.g. 'https://www.airbnb.co.uk/rooms/23860926'.
        - name: check_in
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Check-in date YYYY-MM-DD. With check_out, adds price, availability
              and the cancellation policy.
            title: Check In
          description: >-
            Check-in date YYYY-MM-DD. With check_out, adds price, availability
            and the cancellation policy.
        - name: check_out
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Check-out date YYYY-MM-DD (with check_in).
            title: Check Out
          description: Check-out date YYYY-MM-DD (with check_in).
        - name: adults
          in: query
          required: false
          schema:
            type: integer
            maximum: 16
            minimum: 1
            description: Adult guests (affects the price).
            default: 1
            title: Adults
          description: Adult guests (affects the price).
        - name: children
          in: query
          required: false
          schema:
            type: integer
            maximum: 15
            minimum: 0
            description: Children aged 2-12.
            default: 0
            title: Children
          description: Children aged 2-12.
        - name: infants
          in: query
          required: false
          schema:
            type: integer
            maximum: 5
            minimum: 0
            description: Infants under 2.
            default: 0
            title: Infants
          description: Infants under 2.
        - name: pets
          in: query
          required: false
          schema:
            type: integer
            maximum: 5
            minimum: 0
            description: Pets.
            default: 0
            title: Pets
          description: Pets.
        - name: currency
          in: query
          required: false
          schema:
            type: string
            description: Price currency, ISO code such as USD, EUR, GBP.
            default: USD
            title: Currency
          description: Price currency, ISO code such as USD, EUR, GBP.
        - name: locale
          in: query
          required: false
          schema:
            type: string
            description: >-
              Language for Airbnb's texts, e.g. en, de, fr, es, pt-BR.
              Host-written text is returned translated when Airbnb has a
              translation.
            default: en
            title: Locale
          description: >-
            Language for Airbnb's texts, e.g. en, de, fr, es, pt-BR.
            Host-written text is returned translated when Airbnb has a
            translation.
        - name: include_reviews
          in: query
          required: false
          schema:
            type: boolean
            description: Also return guest reviews.
            default: false
            title: Include Reviews
          description: Also return guest reviews.
        - name: max_reviews
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: How many reviews to return with include_reviews (1-100).
            default: 20
            title: Max Reviews
          description: How many reviews to return with include_reviews (1-100).
        - name: reviews_sort
          in: query
          required: false
          schema:
            type: string
            description: >-
              Review order: most_relevant, most_recent, highest_rated,
              lowest_rated.
            default: most_relevant
            title: Reviews Sort
          description: >-
            Review order: most_relevant, most_recent, highest_rated,
            lowest_rated.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Exit-IP country (ISO-2). Defaults to US.
            title: Proxy Country
          description: Exit-IP country (ISO-2). Defaults to US.
      responses:
        '200':
          description: JSON with the full listing record.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: No such listing (removed, private or wrong id).
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked by Airbnb or no listing data returned.
        '504':
          description: Fetch timed out.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.