$3 / 1k listings
Get Airbnb listing details — price, availability, ratings, host info, amenities — from listing URLs
Endpoint
POST /api/v1/agents/airbnb/listings/run
Parameters
array
required
List · Airbnb listing URLs (https://www.airbnb.com/rooms/…). One per line.
date
Date picker · Check-in date for availability and price.
date
Date picker · Check-out date for availability and price.
integer
Number · Number of adults in the party.
integer
Number · Number of children (ages 2-12).
integer
Number · Number of infants (under 2).
integer
Number · Number of pets.
string
default:"en-US"
Dropdown · Language and region for the listing data.View all 93 options →
string
default:"USD"
Dropdown · Currency for prices.View all 48 options →
Response columns
| Field | Display name | Type |
|---|---|---|
listingUrl | Listing URL | url |
title | Title | text |
description | Description | text |
propertyType | Property Type | text |
roomType | Room Type | text |
capacity | Capacity | number |
homeTier | Home Tier | number |
available | Available | boolean |
location | Location | text |
locationSubtitle | Location Subtitle | text |
latitude | Latitude | number |
longitude | Longitude | number |
guestSatisfaction | Guest Satisfaction | rating |
accuracy | Accuracy | rating |
cleanliness | Cleanliness | rating |
communication | Communication | rating |
checkIn | Check-in | rating |
locationRating | Location Rating | rating |
value | Value | rating |
reviewCount | Review Count | number |
host | Host | text |
hostPicture | Host Picture | url |
coHost | Co-Host | text |
coHostPicture | Co-Host Picture | url |
amenityGroup | Amenity Group | text |
highlight | Highlight | text |
highlightSubtitle | Highlight Subtitle | text |
cancellationPolicy | Cancellation Policy | text |
language | Language | text |
hostIsSuperHost | Host Is Super Host | boolean |
hostIsVerified | Host Is Verified | boolean |
hostRatingAverage | Host Rating Average | number |
hostRatingCount | Host Rating Count | integer |
hostTimeAsHostMonths | Host Time As Host Months | integer |
hostTimeAsHostYears | Host Time As Host Years | integer |
imagesCaption | Images Caption | text |
imageUrl | Image URL | url |
imagesOrientation | Images Orientation | text |
thumbnail | Thumbnail | url |
iosDeepLink | iOS Deep Link | text |
androidDeepLink | Android Deep Link | text |
Example
curl -X POST https://api.mindcase.co/api/v1/agents/airbnb/listings/run \
-H "Authorization: Bearer mk_live_abc123def456" \
-H "Content-Type: application/json" \
-d '{
"params": {
"urls": [
{
"url": "https://www.airbnb.com/rooms/37879131"
},
{
"url": "https://www.airbnb.com/rooms/1010503905929192028"
},
{
"url": "https://www.airbnb.com/rooms/1404403902815216178"
},
{
"url": "https://www.airbnb.com/rooms/1675554791743847017"
},
{
"url": "https://www.airbnb.com/rooms/1285887172744396690"
},
{
"url": "https://www.airbnb.com/rooms/1667608485035315996"
},
{
"url": "https://www.airbnb.com/rooms/1643351505460876003"
},
{
"url": "https://www.airbnb.com/rooms/993759176942173865"
},
{
"url": "https://www.airbnb.com/rooms/700888293266225258"
},
{
"url": "https://www.airbnb.com/rooms/934107469692156357"
}
],
"locale": "en-US",
"currency": "USD"
}
}'
import requests
resp = requests.post(
"https://api.mindcase.co/api/v1/agents/airbnb/listings/run",
headers={"Authorization": "Bearer mk_live_abc123def456"},
json={"params": {
"urls": [
{
"url": "https://www.airbnb.com/rooms/37879131"
},
{
"url": "https://www.airbnb.com/rooms/1010503905929192028"
},
{
"url": "https://www.airbnb.com/rooms/1404403902815216178"
},
{
"url": "https://www.airbnb.com/rooms/1675554791743847017"
},
{
"url": "https://www.airbnb.com/rooms/1285887172744396690"
},
{
"url": "https://www.airbnb.com/rooms/1667608485035315996"
},
{
"url": "https://www.airbnb.com/rooms/1643351505460876003"
},
{
"url": "https://www.airbnb.com/rooms/993759176942173865"
},
{
"url": "https://www.airbnb.com/rooms/700888293266225258"
},
{
"url": "https://www.airbnb.com/rooms/934107469692156357"
}
],
"locale": "en-US",
"currency": "USD"
}},
)
data = resp.json()
Example response
Response
{
"job_id": "job_7f3a2b1c",
"status": "completed",
"data": [
{
"listingUrl": "https://www.airbnb.com/rooms/1667608485035315996?locale=en-US¤cy=USD",
"title": "Studio Ivory | MetLife & Manhattan Near",
"description": "Studio Ivory is a private, modern, and cozy space, ideal for travelers visiting Manhattan or attending events at MetLife Stadium, including the World Cup. Located in North Jersey, it offers quick access to NYC and the stadium by car or public transport. It has a private entrance, a comfortable bed, a private bathroom, a Smart TV, a mini-fridge, and a coffee area. Perfect for relaxing in peace after a day of sightseeing, concerts, or games.",
"propertyType": "Entire rental unit",
"roomType": "Entire home/apt",
"capacity": 2,
"homeTier": 1,
"available": false,
"location": "North Bergen",
"locationSubtitle": "North Bergen, New Jersey, United States",
"latitude": 40.78717795252641,
"longitude": -74.02877929797327,
"guestSatisfaction": 5,
"accuracy": 5,
"cleanliness": 5,
"communication": 5,
"checkIn": 5,
"locationRating": 5,
"value": 5,
"reviewCount": 3,
"host": "Lenin",
"hostPicture": "https://a0.muscache.com/im/pictures/user/3865ddfd-ebeb-4c5d-bd3c-24befd182d61.jpg",
"coHost": null,
"coHostPicture": null,
"amenityGroup": null,
"highlight": null,
"highlightSubtitle": null,
"cancellationPolicy": null,
"language": "en",
"hostIsSuperHost": true,
"hostIsVerified": true,
"hostRatingAverage": 4.91,
"hostRatingCount": 97,
"hostTimeAsHostMonths": 0,
"hostTimeAsHostYears": 1,
"imagesCaption": null,
"imageUrl": null,
"imagesOrientation": null,
"thumbnail": "https://a0.muscache.com/im/pictures/hosting/Hosting-1667608485035315996/original/744b3f1a-db87-4fde-90d5-b06ac2f2cf2b.png",
"iosDeepLink": "airbnb://rooms/1667608485035315996",
"androidDeepLink": "airbnb://rooms/1667608485035315996"
}
]
}