GET

Airbnb Listing Details API

Extract property details from Airbnb listings including title, rating, host info, and guest policies.

Overview

Checkout Data

This endpoint uses Airbnb's checkout API to get accurate, real-time listing information including guest policies.

The Airbnb Listing Details endpoint provides comprehensive property information including listing title, rating, host name, badges, and guest capacity. Requires check-in/check-out dates to access the data.

Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/{listing_id}/details

Parameters

Parameter	Type	Required	Description
listing_id	integer	Required	Airbnb listing ID (path parameter)
check_in	string	Required	Check-in date in YYYY-MM-DD format
check_out	string	Required	Check-out date in YYYY-MM-DD format
adults	integer	Optional	Number of adults (1-16, default: 1)
children	integer	Optional	Number of children (0-10, default: 0)
infants	integer	Optional	Number of infants (0-5, default: 0)
pets	integer	Optional	Number of pets (0-5, default: 0)
currency	string	Optional	Currency code (default: USD)

Response Structure

Listing Information

title - Property title
image_url - Main listing image
rating - Average rating (e.g., "4.86 (886)")
rating_count - Number of reviews
badge - Award badge (e.g., "Guest favorite")
host_name - Host display name

Guest Policies

max_guests - Maximum guest capacity
children_allowed - Whether children are welcome
infants_allowed - Whether infants are welcome
pets_allowed - Whether pets are allowed

Finding the Listing ID

Need the Listing ID?

Use the /listing/extract-id endpoint to extract the listing ID from any Airbnb URL.

The listing ID can be found in Airbnb URLs. For example:


            https://www.airbnb.com/rooms/22135033

The listing ID is 22135033 (the number after "rooms/").

Request

curl -X GET "https://api.stayapi.com/v1/airbnb/listing/22135033/details?check_in=2026-01-30&check_out=2026-02-01&adults=2" \
  -H "x-api-key: YOUR_API_KEY"

const listingId = 22135033;
const params = new URLSearchParams({
  check_in: "2026-01-30",
  check_out: "2026-02-01",
  adults: "2"
});

const response = await fetch(
  `https://api.stayapi.com/v1/airbnb/listing/${listingId}/details?${params}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();

console.log(`Title: ${data.details.title}`);
console.log(`Rating: ${data.details.rating}`);
console.log(`Host: ${data.details.host_name}`);
console.log(`Max Guests: ${data.details.max_guests}`);

import requests

listing_id = 22135033
url = f"https://api.stayapi.com/v1/airbnb/listing/{listing_id}/details"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "check_in": "2026-01-30",
    "check_out": "2026-02-01",
    "adults": 2
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

# Display listing details
details = data["details"]
print(f"Title: {details['title']}")
print(f"Rating: {details['rating']}")
print(f"Host: {details['host_name']}")
print(f"Badge: {details['badge']}")
print(f"Max Guests: {details['max_guests']}")

<?php
$listingId = 22135033;
$url = "https://api.stayapi.com/v1/airbnb/listing/" . $listingId . "/details";
$params = http_build_query([
    "check_in" => "2026-01-30",
    "check_out" => "2026-02-01",
    "adults" => 2
]);

$ch = curl_init($url . "?" . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

// Display listing details
$details = $data["details"];
echo "Title: " . $details["title"] . "\n";
echo "Rating: " . $details["rating"] . "\n";
echo "Host: " . $details["host_name"] . "\n";
?>

require "net/http"
require "json"
require "uri"

listing_id = 22135033
uri = URI("https://api.stayapi.com/v1/airbnb/listing/\#{listing_id}/details")
uri.query = URI.encode_www_form({
  check_in: "2026-01-30",
  check_out: "2026-02-01",
  adults: 2
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "YOUR_API_KEY"

response = http.request(request)
data = JSON.parse(response.body)

# Display listing details
details = data["details"]
puts "Title: \#{details['title']}"
puts "Rating: \#{details['rating']}"
puts "Host: \#{details['host_name']}"
puts "Max Guests: \#{details['max_guests']}"

Response

{
  "success": true,
  "listing_id": 22135033,
  "check_in": "2026-01-30",
  "check_out": "2026-02-01",
  "nights": 2,
  "details": {
    "title": "Central Warsaw Studio \"Zgoda BLUE\"",
    "image_url": "https://a0.muscache.com/im/pictures/804ec3dd-...",
    "rating": "4.86 (886)",
    "rating_count": 886,
    "badge": "Guest favorite",
    "host_name": "Zuzanna And Milosz",
    "max_guests": 2,
    "children_allowed": true,
    "infants_allowed": false,
    "pets_allowed": false
  }
}

{
  "error": "Invalid dates",
  "detail": "check_out must be after check_in",
  "status_code": 400
}