Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$2 / 1k listings Search Airbnb listings by location, or pull listing details from URLs — price, ratings, host info, amenities

Endpoint

POST /api/v1/agents/airbnb/search/run

Parameters

location
array
List · Cities or regions to search Airbnb in (e.g. ‘New York’, ‘Paris’). One per line.
urls
array
List · Airbnb listing URLs (rooms/…) or search URLs (s/…). One per line. Use this OR Locations.
maxResults
integer
default:50
Number · Max listings per location (search mode only). Use 0 for all.
checkIn
date
Date picker · Check-in date for availability and price.
checkOut
date
Date picker · Check-out date for availability and price.
adults
integer
Number · Number of adults in the party.
children
integer
Number · Number of children (ages 2-12).
infants
integer
Number · Number of infants (under 2).
pets
integer
Number · Number of pets.
locale
string
default:"en-US"
Dropdown · Language and region for the listing data.View all 93 options →
currency
string
default:"USD"
Dropdown · Currency for prices.View all 48 options →

Response columns

FieldDisplay nameType
listingUrlListing URLurl
titleTitletext
descriptionDescriptiontext
propertyTypeProperty Typetext
roomTypeRoom Typetext
capacityCapacitynumber
homeTierHome Tiernumber
availableAvailableboolean
locationLocationtext
locationSubtitleLocation Subtitletext
latitudeLatitudenumber
longitudeLongitudenumber
guestSatisfactionGuest Satisfactionrating
accuracyAccuracyrating
cleanlinessCleanlinessrating
communicationCommunicationrating
checkInCheck-inrating
locationRatingLocation Ratingrating
valueValuerating
reviewCountReview Countnumber
hostHosttext
hostPictureHost Pictureurl
hostIdHost IDtext
coHostCo-Hosttext
coHostPictureCo-Host Pictureurl
amenityGroupAmenity Grouptext
highlightHighlighttext
highlightSubtitleHighlight Subtitletext
cancellationPolicyCancellation Policytext
priceLabelPrice Labeltext
languageLanguagetext
hostHighlightsHost Highlightstext
hostHostDetailsHost Host Detailstext
hostIsSuperHostHost Is Super Hostboolean
hostIsVerifiedHost Is Verifiedboolean
hostRatingAverageHost Rating Averagenumber
hostRatingCountHost Rating Countinteger
hostTimeAsHostMonthsHost Time As Host Monthsinteger
hostTimeAsHostYearsHost Time As Host Yearsinteger
descriptionTextDescription Texttext
imagesCaptionImages Captiontext
imagesImageUrlImages Image URLurl
imagesOrientationImages Orientationtext
locationDescriptionsContentLocation Descriptions Contenttext
locationDescriptionsMapMarkerRadiusInMetersLocation Descriptions Map Marker Radius In Metersinteger
locationDescriptionsTitleLocation Descriptions Titletext
subDescriptionItemsSub Description Itemstext
subDescriptionTitleSub Description Titletext
thumbnailThumbnailurl
iosDeepLinkiOS Deep Linktext
androidDeepLinkAndroid Deep Linktext

Example

curl -X POST https://api.mindcase.co/api/v1/agents/airbnb/search/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "locationQueries": [
      "New York"
    ],
    "currency": "USD",
    "locale": "en-US",
    "maxItems": 10,
    "includeUserProfiles": false
  }
}'

Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "listingUrl": "https://www.airbnb.com/rooms/1645078905087022091?locale=en-US&currency=USD&check_in=2026-05-03&check_out=2026-05-08",
      "title": "Steps to Barclays Center + Work Spaces & Free WiFi",
      "description": "Experience the artistic energy of Gowanus at The Industrialist, a boutique hotel where renovated warehouses meet modern design. Located steps from the Union Street (R) station, you are 20 minutes from Manhattan and walking distance to the Barclays Center. Our micro-rooms feature Chromecast-equipped TVs, high-speed Wi-Fi, and plush beds. Managed via the Sonder app, guests enjoy contactless service, an on-site front desk, and easy access to local breweries and Michelin-star dining.The space\u2728 Top Reasons Guests Book This Stay\n\n\u2714\ufe0f Experience a premier location in Brooklyn\u2019s trendy Gowanus neighborhood, just steps from the Union Street (R) subway station for easy access to Manhattan.\n\u2714\ufe0f Stay within walking distance of the Barclays Center, perfect for guests attending concerts, events, or Brooklyn Nets games.\n\u2714\ufe0f Immerse yourself in a boutique hotel atmosphere where industrial Brooklyn grit meets chic, modern design in a renovated warehouse setting.\n\u2714\ufe0f Enjoy a seamless, tech-forward experience with contactless check-in and 24/7 guest support managed entirely through the Sonder app.\n\u2714\ufe0f Benefit from high-end in-room amenities, including high-speed Wi-Fi and Chromecast-equipped TVs for personalized entertainment.\n\n\u2728 About Your Stay \u2013 One Queen Guest Room\nWelcome to your artistic and thoughtfully designed retreat in the heart of Gowanus. Our Queen Room offers a cozy, \"micro-room\" efficiency that doesn't compromise on style, blending industrial elements with contemporary comforts. Featuring a plush queen-size bed and large windows that invite natural light, this non-smoking sanctuary is ideal for solo adventurers or couples looking for a stylish urban base. With high-speed Wi-Fi and a streamlined layout, you'll find everything you need to recharge after exploring Brooklyn\u2019s world-class breweries and galleries.\n\n\u2728 Room Highlights\n\u2714\ufe0f One plush queen-size bed featuring premium linens and comfortable bedding.\n\u2714\ufe0f In-room coffee/tea maker to jumpstart your morning before heading out to explore Brooklyn.\n\u2714\ufe0f Flat-screen TV equipped with Chromecast for seamless streaming of your favorite content.\n\u2714\ufe0f Complimentary high-speed Wi-Fi to keep you connected for work or leisure throughout your stay.\n\u2714\ufe0f Private bathroom featuring a modern walk-in shower and designer bath amenities.\n\u2714\ufe0f Individually controlled air conditioning and heating for your personalized climate comfort.\n\u2714\ufe0f Large windows providing neighborhood views and plenty of natural Brooklyn light.\n\u2714\ufe0f Streamlined storage and closet space designed for maximum efficiency in a micro-room layout.\n\u2714\ufe0f Practical conveniences including a hair dryer and professional-grade iron/ironing board.\n\n\u2728 On-Site Amenities Guests Love\n\u2714\ufe0f Contactless Check-In: Skip the line and head straight to your room using your smartphone and the Sonder app.\n\u2714\ufe0f 24/7 Guest Support: Access help, request fresh towels, or get local recommendations anytime via mobile messaging.\n\u2714\ufe0f On-Site Front Desk: Enjoy the peace of mind of having staff available on-site to assist with your stay.\n\u2714\ufe0f Artistic Common Spaces: Relax in a beautifully renovated industrial space that reflects the creative spirit of the neighborhood.\n\u2714\ufe0f Elevator Access: Easily reach your floor with full elevator service throughout the property.\n\n\u2728 Nearby Favorites\n\u2714\ufe0f Barclays Center \u2013 Catch a game or a show at this world-class arena, located just a 15-minute walk away.\n\u2714\ufe0f Royal Palms Shuffle Club \u2013 Experience one of Brooklyn's most famous social spots for shuffleboard and tropical drinks just around the corner.\n\u2714\ufe0f Park Slope \u2013 Explore the charming brownstones, boutiques, and cafes of this iconic neighbor, only a 10-minute stroll away.\n\u2714\ufe0f Gowanus Canal & Breweries \u2013 Discover local favorites like Threes Brewing and Other Half Brewing within blocks of the hotel.\n\u2714\ufe0f Prospect Park \u2013 Enjoy 500+ acres of green space, scenic trails, and the Brooklyn Botanic Garden, just a short subway ride or 20-minute walk.Guest access24/7 coverage service prepared to welcome youOther things to note\u2728 Good to Know Before You Book\n\n\u25b6 Check-In Information & Additional Rules\n\u2714\ufe0f Check-In: Starts at 4:00 PM / Check-Out: Until 11:00 AM.\n\u2714\ufe0f You must be 21 to rent this room. Only the person's name on the booking will be allowed to check in.\n\u2714\ufe0f Valid photo ID and credit card required at check-in. Special requests are subject to availability; additional charges may apply.\n\u2714\ufe0f A refundable incidental deposit is required at check-in.\n\u2757 IMPORTANT NOTE: Guests who do not check in as scheduled will be considered a no-show.\n\n\u25b6 Parking\n\u2714\ufe0f Paid Parking: On-site parking is not provided; however, off-site parking is possible nearby.\n\n\u25b6 Food and Drink\n\u2714\ufe0f No Breakfast: This property does not offer breakfast service.\n\u2714\ufe0f Local Flavors: The neighborhood is a top-rated destination for walkable bars, cafes, and Michelin-starred dining.\n\n\u25b6 Pets\n\u2714\ufe0f Pets Not Allowed: This property maintains a strict no-pet policy.\n\n\u25b6 Property Perks Airbnb Guests Love\n\u2714\ufe0f Special Features: Stay active in our on-site fitness room or store gear in secure lockers.\n\u2714\ufe0f 24/7 Service: Benefit from a 24-hour reception, professional staff, and baggage storage for your convenience.\n\u2714\ufe0f Modern Comforts: This is a boutique property featuring high-speed Wi-Fi, air conditioning, and heating.\n\u2714\ufe0f Boutique Design: Enjoy a renovated warehouse stay featuring terraces (in select rooms), elevators, and in-room microwaves.Registration DetailsExempt",
      "propertyType": "Room in hotel",
      "roomType": "Private room",
      "capacity": 2,
      "homeTier": 1,
      "available": true,
      "location": "Brooklyn",
      "locationSubtitle": "Brooklyn, New York, United States",
      "latitude": 40.676937956248416,
      "longitude": -73.98321344419193,
      "guestSatisfaction": 4.56,
      "accuracy": 4.61,
      "cleanliness": 4.72,
      "communication": 4.5,
      "checkIn": 4.67,
      "locationRating": 4.61,
      "value": 4.44,
      "reviewCount": 18,
      "host": "The Industrialist Hotel Gowanus Brooklyn NYC",
      "hostPicture": "https://a0.muscache.com/im/pictures/user/User/original/39ca6e37-161a-4929-b789-d8c5f5d187d5.jpeg",
      "hostId": "446994202",
      "coHost": null,
      "coHostPicture": null,
      "amenityGroup": null,
      "highlight": null,
      "highlightSubtitle": null,
      "cancellationPolicy": null,
      "priceLabel": "$740 total, originally $1,007",
      "language": "en",
      "hostHighlights": [
        "Lives in Camden, New Jersey"
      ],
      "hostHostDetails": [
        "Response rate: 100%",
        "Responds within an hour"
      ],
      "hostIsSuperHost": false,
      "hostIsVerified": true,
      "hostRatingAverage": 4.73,
      "hostRatingCount": 60,
      "hostTimeAsHostMonths": 2,
      "hostTimeAsHostYears": 4,
      "descriptionText": "Experience the artistic energy of Gowanus at The Industrialist, a boutique hotel where renovated warehouses meet modern design. Located steps from the Union Street (R) station, you are 20 minutes from Manhattan and walking distance to the Barclays Center. Our micro-rooms feature Chromecast-equipped TVs, high-speed Wi-Fi, and plush beds. Managed via the Sonder app, guests enjoy contactless service, an on-site front desk, and easy access to local breweries and Michelin-star dining.<br /><br /><b>The space</b><br />\u2728 Top Reasons Guests Book This Stay\r<br />\r<br />\u2714\ufe0f Experience a premier location in Brooklyn\u2019s trendy Gowanus neighborhood, just steps from the Union Street (R) subway station for easy access to Manhattan.\r<br />\u2714\ufe0f Stay within walking distance of the Barclays Center, perfect for guests attending concerts, events, or Brooklyn Nets games.\r<br />\u2714\ufe0f Immerse yourself in a boutique hotel atmosphere where industrial Brooklyn grit meets chic, modern design in a renovated warehouse setting.\r<br />\u2714\ufe0f Enjoy a seamless, tech-forward experience with contactless check-in and 24/7 guest support managed entirely through the Sonder app.\r<br />\u2714\ufe0f Benefit from high-end in-room amenities, including high-speed Wi-Fi and Chromecast-equipped TVs for personalized entertainment.\r<br />\r<br />\u2728 About Your Stay \u2013 One Queen Guest Room\r<br />Welcome to your artistic and thoughtfully designed retreat in the heart of Gowanus. Our Queen Room offers a cozy, \"micro-room\" efficiency that doesn't compromise on style, blending industrial elements with contemporary comforts. Featuring a plush queen-size bed and large windows that invite natural light, this non-smoking sanctuary is ideal for solo adventurers or couples looking for a stylish urban base. With high-speed Wi-Fi and a streamlined layout, you'll find everything you need to recharge after exploring Brooklyn\u2019s world-class breweries and galleries.\r<br />\r<br />\u2728 Room Highlights\r<br />\u2714\ufe0f One plush queen-size bed featuring premium linens and comfortable bedding.\r<br />\u2714\ufe0f In-room coffee/tea maker to jumpstart your morning before heading out to explore Brooklyn.\r<br />\u2714\ufe0f Flat-screen TV equipped with Chromecast for seamless streaming of your favorite content.\r<br />\u2714\ufe0f Complimentary high-speed Wi-Fi to keep you connected for work or leisure throughout your stay.\r<br />\u2714\ufe0f Private bathroom featuring a modern walk-in shower and designer bath amenities.\r<br />\u2714\ufe0f Individually controlled air conditioning and heating for your personalized climate comfort.\r<br />\u2714\ufe0f Large windows providing neighborhood views and plenty of natural Brooklyn light.\r<br />\u2714\ufe0f Streamlined storage and closet space designed for maximum efficiency in a micro-room layout.\r<br />\u2714\ufe0f Practical conveniences including a hair dryer and professional-grade iron/ironing board.\r<br />\r<br />\u2728 On-Site Amenities Guests Love\r<br />\u2714\ufe0f Contactless Check-In: Skip the line and head straight to your room using your smartphone and the Sonder app.\r<br />\u2714\ufe0f 24/7 Guest Support: Access help, request fresh towels, or get local recommendations anytime via mobile messaging.\r<br />\u2714\ufe0f On-Site Front Desk: Enjoy the peace of mind of having staff available on-site to assist with your stay.\r<br />\u2714\ufe0f Artistic Common Spaces: Relax in a beautifully renovated industrial space that reflects the creative spirit of the neighborhood.\r<br />\u2714\ufe0f Elevator Access: Easily reach your floor with full elevator service throughout the property.\r<br />\r<br />\u2728 Nearby Favorites\r<br />\u2714\ufe0f Barclays Center \u2013 Catch a game or a show at this world-class arena, located just a 15-minute walk away.\r<br />\u2714\ufe0f Royal Palms Shuffle Club \u2013 Experience one of Brooklyn's most famous social spots for shuffleboard and tropical drinks just around the corner.\r<br />\u2714\ufe0f Park Slope \u2013 Explore the charming brownstones, boutiques, and cafes of this iconic neighbor, only a 10-minute stroll away.\r<br />\u2714\ufe0f Gowanus Canal & Breweries \u2013 Discover local favorites like Threes Brewing and Other Half Brewing within blocks of the hotel.\r<br />\u2714\ufe0f Prospect Park \u2013 Enjoy 500+ acres of green space, scenic trails, and the Brooklyn Botanic Garden, just a short subway ride or 20-minute walk.<br /><br /><b>Guest access</b><br />24/7 coverage service prepared to welcome you<br /><br /><b>Other things to note</b><br />\u2728 Good to Know Before You Book\r<br />\r<br />\u25b6 Check-In Information & Additional Rules\r<br />\u2714\ufe0f Check-In: Starts at 4:00 PM / Check-Out: Until 11:00 AM.\r<br />\u2714\ufe0f You must be 21 to rent this room. Only the person's name on the booking will be allowed to check in.\r<br />\u2714\ufe0f Valid photo ID and credit card required at check-in. Special requests are subject to availability; additional charges may apply.\r<br />\u2714\ufe0f A refundable incidental deposit is required at check-in.\r<br />\u2757 IMPORTANT NOTE: Guests who do not check in as scheduled will be considered a no-show.\r<br />\r<br />\u25b6 Parking\r<br />\u2714\ufe0f Paid Parking: On-site parking is not provided; however, off-site parking is possible nearby.\r<br />\r<br />\u25b6 Food and Drink\r<br />\u2714\ufe0f No Breakfast: This property does not offer breakfast service.\r<br />\u2714\ufe0f Local Flavors: The neighborhood is a top-rated destination for walkable bars, cafes, and Michelin-starred dining.\r<br />\r<br />\u25b6 Pets\r<br />\u2714\ufe0f Pets Not Allowed: This property maintains a strict no-pet policy.\r<br />\r<br />\u25b6 Property Perks Airbnb Guests Love\r<br />\u2714\ufe0f Special Features: Stay active in our on-site fitness room or store gear in secure lockers.\r<br />\u2714\ufe0f 24/7 Service: Benefit from a 24-hour reception, professional staff, and baggage storage for your convenience.\r<br />\u2714\ufe0f Modern Comforts: This is a boutique property featuring high-speed Wi-Fi, air conditioning, and heating.\r<br />\u2714\ufe0f Boutique Design: Enjoy a renovated warehouse stay featuring terraces (in select rooms), elevators, and in-room microwaves.<br /><br /><b>Registration Details</b><br />Exempt",
      "imagesCaption": null,
      "imagesImageUrl": null,
      "imagesOrientation": null,
      "locationDescriptionsContent": null,
      "locationDescriptionsMapMarkerRadiusInMeters": null,
      "locationDescriptionsTitle": null,
      "subDescriptionItems": [
        "2 guests",
        "1 bedroom",
        "1 bed",
        "1 private bath"
      ],
      "subDescriptionTitle": "Room in hotel in Brooklyn, New York",
      "thumbnail": "https://a0.muscache.com/im/pictures/prohost-api/Hosting-1645078905087022091/original/69e1b50b-6b6d-4e36-82f6-eac490fcb141.png",
      "iosDeepLink": "airbnb://rooms/1645078905087022091",
      "androidDeepLink": "airbnb://rooms/1645078905087022091"
    }
  ]
}