Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Airbnb action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Find Airbnb stays for a destination passed in keyword, with optional currency, language and price-band filters. | $1.39 per 1,000 requests | Normal |
Property detailsproperty_detail | Read one Airbnb listing from its /rooms/ link or property ID, covering room type, guest capacity, bedrooms, beds, bathrooms, amenities, rating and host. | $1.39 per 1,000 requests | Normal |
Reviewsreviews | Pull guest reviews for an Airbnb listing, each with text, rating, date, language, reviewer name and location, and any host reply. | $1.39 per 1,000 requests | Normal |
Host profileshost | Look up an Airbnb host from a profile link or host ID to get their name, bio, languages, rating, superhost status, join date and listing count. | $1.39 per 1,000 requests | Normal |
Availability calendarcalendar | Check day-by-day availability for an Airbnb listing, including whether each date works for check-in or check-out, minimum and maximum nights, and price. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Airbnb action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Find Airbnb stays for a destination passed in | keyword | currency, lang, locale, max_price, min_price | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · property_type · person_capacity · price · rating · rating_scale · review_count · lat · lng · location · host_name · amenities · image_url · check_in · check_out · platform |
property_detailProperty details Read one Airbnb listing from its /rooms/ link or property ID, covering room type, guest capacity, bedrooms, beds, bathrooms, amenities, rating and host. The optional | url | city, max_price, min_price | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · text · property_type · room_type · person_capacity · bedrooms · bathrooms · beds · location · lat · lng · rating · rating_scale · review_count · price · currency · host_name · is_superhost · amenities · platform |
reviewsReviews Pull guest reviews for an Airbnb listing, each with text, rating, date, language, reviewer name and location, and any host reply. Narrow by language, a | url | lang, locale, since, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform |
hostHost profiles Look up an Airbnb host from a profile link or host ID to get their name, bio, languages, rating, superhost status, join date and listing count. Pass a /users/show/ link or host ID, not a listing ID; the profile does not verify the host's identity. | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform |
calendarAvailability calendar Check day-by-day availability for an Airbnb listing, including whether each date works for check-in or check-out, minimum and maximum nights, and price. Without dates, the window runs from today for 30 days; reading the calendar never holds or books a stay. | url | check_in, check_out, end_date, since, start_date, until | Sync delivery | — | $1.39 per 1,000 requests | id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform |
What do the Airbnb search parameters mean?
Find Airbnb stays for a destination passed in keyword, with optional currency, language and price-band filters. Each row lists property type, guest capacity, price and rating as shown, but does not confirm availability for particular dates.
keywordRequired- Specifies the target location, city, region, or destination name (for example, Tokyo) for the search action. Pass a place name rather than a host username or property ID.
currencyOptional- Specifies the listing display currency for Airbnb search results (default USD; see allowed values). This setting changes the currency used for property prices, but it does not alter EveryInfra API request billing or wallet currency.Allowed values:
aedaudbgnbrlcadchfclpcnycopcrcczkdkkegpeurgbpghshkdhrkhufidrilsinrjpykeskrwkztmadmxnmyrnoknzdpenphpplnqarronsarseksgdthbtrytwduahugxusduyuvndzar langOptional- Specifies the language and region combination using compact codes such as enus for en-US, zhcn for zh-CN, or jajp for ja-JP. Pass one of the exact listed allowed values rather than generic two-letter language codes like en.Allowed values:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeOptional- Sets the Airbnb page display locale (default en-US), such as en-US or zh-CN. Do not pass locale alongside lang; lang takes precedence and overrides the language selection. This parameter does not filter reviews by reviewer nationality.
max_priceOptional- Sets the maximum property price filter as a numeric value. It must be greater than or equal to min_price. Use this to filter search results, not to constrain single API request costs or overall lodging budgets.
min_priceOptional- Sets the minimum property price filter as a numeric value when paired with max_price. This parameter filters listing search results and does not set an API usage cap.
What do the Airbnb property_detail parameters mean?
Read one Airbnb listing from its /rooms/ link or property ID, covering room type, guest capacity, bedrooms, beds, bathrooms, amenities, rating and host. The optional city and price filters do not turn it into a search or a booking quote.
urlRequired- Identifies the target resource based on the action: pass a /rooms/<property_id> URL or property ID for property_detail, reviews, or calendar, or a /users/show/<host_id> URL or host ID for host. Property and host identifiers are not interchangeable.Airbnb: Listing Reviews and Visibility Limits — Airbnb distinguishes public reviews and overall star ratings from category sub-ratings visible only to hosts and the platform. Overall listing scores and host scores spanning multiple listings are calculated separately and must not be conflated. · Checked
cityOptional- Specifies the free-text city name filter for property detail queries. Enter a city name, not a property ID or country code.
max_priceOptional- Sets the maximum property price filter as a numeric value. It must be greater than or equal to min_price. Use this to filter search results, not to constrain single API request costs or overall lodging budgets.
min_priceOptional- Sets the minimum property price filter as a numeric value when paired with max_price. This parameter filters listing search results and does not set an API usage cap.
What do the Airbnb reviews parameters mean?
Pull guest reviews for an Airbnb listing, each with text, rating, date, language, reviewer name and location, and any host reply. Narrow by language, a since date or sort order; one batch is not necessarily the full review history.
urlRequired- Identifies the target resource based on the action: pass a /rooms/<property_id> URL or property ID for property_detail, reviews, or calendar, or a /users/show/<host_id> URL or host ID for host. Property and host identifiers are not interchangeable.Airbnb: Listing Reviews and Visibility Limits — Airbnb distinguishes public reviews and overall star ratings from category sub-ratings visible only to hosts and the platform. Overall listing scores and host scores spanning multiple listings are calculated separately and must not be conflated. · Checked
langOptional- Specifies the language and region combination using compact codes such as enus for en-US, zhcn for zh-CN, or jajp for ja-JP. Pass one of the exact listed allowed values rather than generic two-letter language codes like en.Allowed values:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeOptional- Sets the Airbnb page display locale (default en-US), such as en-US or zh-CN. Do not pass locale alongside lang; lang takes precedence and overrides the language selection. This parameter does not filter reviews by reviewer nationality.
sinceOptional- Sets a YYYY-MM-DD start date with action-dependent scope: for reviews, it sets the starting review date; for calendar, it sets the date window start and overrides start_date and check_in.
sortOptional- Sorts guest reviews by newest (default), relevance, or top_rated. This parameter applies only to review order, not listing prices.Allowed values:
newestrelevancetop_rated
What do the Airbnb host parameters mean?
Look up an Airbnb host from a profile link or host ID to get their name, bio, languages, rating, superhost status, join date and listing count. Pass a /users/show/ link or host ID, not a listing ID; the profile does not verify the host's identity.
Full API reference: parameters, code samples, response example and health →urlRequired- Identifies the target resource based on the action: pass a /rooms/<property_id> URL or property ID for property_detail, reviews, or calendar, or a /users/show/<host_id> URL or host ID for host. Property and host identifiers are not interchangeable.Airbnb: Host Ratings vs. Listing Ratings — Airbnb aggregates overall listing ratings to compute a host rating. Retrieving a host profile score does not allow that rating to be applied directly to an individual property. · Checked
What do the Airbnb calendar parameters mean?
Check day-by-day availability for an Airbnb listing, including whether each date works for check-in or check-out, minimum and maximum nights, and price. Without dates, the window runs from today for 30 days; reading the calendar never holds or books a stay.
Full API reference: parameters, code samples, response example and health →urlRequired- Identifies the target resource based on the action: pass a /rooms/<property_id> URL or property ID for property_detail, reviews, or calendar, or a /users/show/<host_id> URL or host ID for host. Property and host identifiers are not interchangeable.
check_inOptional- Sets a compatibility YYYY-MM-DD start date for the calendar action. If start_date is also supplied, start_date takes precedence; providing since overrides both. Querying calendar dates does not initiate a booking.
check_outOptional- Sets a compatibility YYYY-MM-DD end date for the calendar action. If end_date is also supplied, end_date takes precedence; providing until overrides both. Querying calendar dates does not hold property availability.
end_dateOptional- Sets the YYYY-MM-DD end date for calendar availability queries. If omitted, the request falls back to check_out or 30 days from the query date (not start_date plus 30 days). Providing until overrides this parameter.
sinceOptional- Sets a YYYY-MM-DD start date with action-dependent scope: for reviews, it sets the starting review date; for calendar, it sets the date window start and overrides start_date and check_in.
start_dateOptional- Sets the YYYY-MM-DD start date for calendar availability queries. If omitted, the request falls back to check_in or the current date. Providing since overrides this parameter.
untilOptional- Sets the YYYY-MM-DD end date for the calendar action and overrides end_date and check_out. This parameter controls calendar date windows and does not filter review publication dates.
How to use the Airbnb API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"airbnb","action":"search","params":{"keyword":"<keyword>"}}'
Airbnb API questions
What can I retrieve with the Airbnb API?
Set platform to airbnb. The current catalog lists search, property details, reviews, host profiles, and availability calendar. These action names identify different Airbnb objects or views; they are not interchangeable search modes.
Which input starts a Airbnb `search` request?
Specifies the target location, city, region, or destination name (for example, Tokyo) for the search action. Pass a place name rather than a host username or property ID. Send it as keyword inside params.
Which fields can Airbnb `search` return?
Its declared schema includes title, text, property_type, and person_capacity. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Airbnb action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.