{"uid":"cap_OkzIJHOsgOzpHuo3lcFnQ","slug":"airbnb-listing-search-scraper-f662e085","name":"Airbnb Listing Search & Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/airbnb?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pets":{"type":"integer","minimum":0,"description":"Number of pets."},"adults":{"type":"integer","minimum":1,"description":"Number of adult guests."},"checkIn":{"type":"string","description":"Arrival date in YYYY-MM-DD format. Use with checkOut for date-specific prices."},"infants":{"type":"integer","minimum":0,"description":"Number of infant guests."},"minBeds":{"type":"integer","minimum":0,"description":"Only search homes with at least this many beds."},"checkOut":{"type":"string","description":"Departure date in YYYY-MM-DD format; must be after checkIn."},"children":{"type":"integer","minimum":0,"description":"Number of child guests."},"currency":{"type":"string","default":"USD","description":"Currency requested for search prices."},"priceMax":{"type":"integer","minimum":0,"description":"Maximum nightly price filter in the selected currency."},"priceMin":{"type":"integer","minimum":0,"description":"Minimum nightly price filter in the selected currency."},"roomTypes":{"type":"array","default":[],"description":"Optional room type filters, such as Entire home/apt or Private room."},"startUrls":{"type":"array","default":[],"description":"Public Airbnb search URLs, including any filters already in the URL. Room URLs are not accepted."},"maxResults":{"type":"integer","default":100,"minimum":0,"description":"Maximum unique listings across all searches. Set 0 to collect all publicly paginated results."},"minBedrooms":{"type":"integer","minimum":0,"description":"Only search homes with at least this many bedrooms."},"minBathrooms":{"type":"integer","minimum":0,"description":"Only search homes with at least this many bathrooms."},"includeDetails":{"type":"boolean","default":true,"description":"Open each public room page for description, host, amenities, ratings, photos, and rules."},"locationQueries":{"type":"array","description":"City, region, or destination names to search."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"title":null,"subtitle":null,"searchUrl":null,"description":null,"searchQuery":null,"descriptionOriginalLanguage":null}],"product":"airbnb"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZIOsY7AsVeWcqw7KQGH_9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes Airbnb search results by location query or search URL, returning structured listing data including prices, descriptions, amenities, host info, and ratings.","exampleAgentPrompt":"Search Airbnb for entire home listings in Lisbon, Portugal for 2 adults and 1 child checking in June 10 and checking out June 17, with at least 2 bedrooms, no more than $200 per night — grab up to 20 results with full details including amenities and host info.","exampleUseCases":[{"title":"Pet-friendly vacation rental search","prompt":"Find me Airbnb listings in Asheville, NC for 2 adults and 1 pet checking in August 3 and out August 10, minimum 1 bedroom, under $150 a night — only show entire homes or apartments."},{"title":"Group trip accommodation research","prompt":"Search Airbnb for places in Barcelona that can fit 6 adults, checking in September 15 and out September 22, with at least 3 bedrooms and 2 bathrooms — I want full details on the top 15 listings."},{"title":"Budget travel listing comparison","prompt":"Look up Airbnb private room listings in Tokyo for 1 adult, check-in November 1, check-out November 7, priced between $30 and $80 per night — return up to 25 results with descriptions and ratings."}],"resultDescription":"Returns a JSON object with a count of listings found and an array of listing items, each containing the listing ID, URL, title, subtitle, description, search URL, search query, and original language of the description. When includeDetails is true, additional data such as amenities, host information, photos, ratings, and house rules are included per listing.","failureModes":["Empty results if the location query or URL yields no Airbnb listings (not charged)","Invalid or non-search Airbnb URLs (room URLs are rejected)","Airbnb anti-scraping measures may cause intermittent failures","checkOut date before or equal to checkIn date causes validation failure","Invalid date format (non YYYY-MM-DD) causes rejection","Airbnb may limit pagination for very broad searches, capping total results"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Airbnb listing data — including prices, amenities, host details, and ratings — for one or more destinations and date ranges. It is especially useful for travel planning agents, rental market research, price comparison tools, or any workflow that needs to systematically collect Airbnb search results without building and maintaining a custom scraper. The pay-per-call model with no charge for failed/empty runs makes it low-risk for exploratory queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:43:54.165Z","isFirstParty":false,"canonicalSlug":"airbnb-listing-search-scraper-f662e085"}