> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Airbnb Listing Details
> Get Airbnb listing details — price, availability, ratings, host info, amenities — from listing URLs
`$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
**List** · Airbnb listing URLs ([https://www.airbnb.com/rooms/](https://www.airbnb.com/rooms/)...). One per line.
**Date picker** · Check-in date for availability and price.
**Date picker** · Check-out date for availability and price.
**Number** · Number of adults in the party.
**Number** · Number of children (ages 2-12).
**Number** · Number of infants (under 2).
**Number** · Number of pets.
**Dropdown** · Language and region for the listing data.
[View all 93 options →](/agents/airbnb/listings/values#locale)
**Dropdown** · Currency for prices.
[View all 48 options →](/agents/airbnb/listings/values#currency)
## 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
```bash curl theme={null}
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"
}
}'
```
```python Python theme={null}
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
```json Response theme={null}
{
"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"
}
]
}
```