EveryData platform API
Airbnb API
Airbnb separates property listings, listing details, host profiles, guest reviews, and availability calendars across 5 documented actions (`search`, `property_detail`, `reviews`, `host`, `calendar`), keeping discovery and object-detail contracts distinct.
Start with `search` for matching Airbnb results and move to `property_detail` for one property record; `search` uses `keyword`, whereas `property_detail` uses `url`, so the two result shapes stay distinct.
- Endpoint
- POST /api/v1/social
- Capabilities
- 5
- Per 1,000
- $1.389
Available capabilities
Compare the Airbnb actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Use Airbnb | 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 The | 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 Airbnb exposes review records under the | 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 Choose | 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 Treat | 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 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.
What do the Airbnb search parameters mean?
Use Airbnb search to discover Airbnb public results. For Airbnb search, supply keyword, lang, min_price, max_price, locale, and currency; results include review_count, check_in, text, rating, host_name, rating_scale, url, lng, check_out, amenities, image_url, lat, person_capacity, location, price, title, platform, property_type, and id.
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?
The property_detail selection separates one property record from other Airbnb objects. Use Airbnb property_detail with url; Airbnb then selects one property record. Airbnb property_detail takes max_price, min_price, city, and url and yields lng, lat, text, bedrooms, beds, currency, url, title, id, platform, room_type, host_name, amenities, rating_scale, review_count, location, is_superhost, property_type, rating, person_capacity, price, and bathrooms.
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 LimitsAirbnb 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?
Airbnb exposes review records under the reviews identifier. Use Airbnb reviews with url; Airbnb then selects review records. Airbnb reviews takes url, lang, locale, since, and sort and yields author_location, language, rating_scale, url, platform, response, author_name, posted_at, id, rating, and text.
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 LimitsAirbnb 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?
Choose host when the Airbnb target is one host profile. Use Airbnb host with url; Airbnb then selects one host profile. For Airbnb host, supply url; results include name, avatar_url, id, listing_count, platform, is_superhost, review_count, rating_scale, joined_at, rating, listing_urls, languages, url, and text.
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 RatingsAirbnb 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?
Treat calendar as the Airbnb view for an availability calendar. Use Airbnb calendar with url; Airbnb then selects an availability calendar. For Airbnb calendar, supply since, start_date, check_in, check_out, end_date, until, and url; results include platform, available_for_checkin, max_nights, price, currency, available, id, min_nights, bookable, available_for_checkout, and date.
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 selected action is asynchronous.
- 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 source record, and every other action has its own field list.
Does every Airbnb action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.