EveryData platform API
Booking API
The scope of this Booking API is Booking.com properties, guest reviews, property details, and displayed prices; its 4 actions, including `search`, `profile`, `reviews`, retain independent inputs and returned-object meanings.
In the Booking catalog, `keyword` drives `search` for matching Booking results, whereas `url` drives `profile` for the selected Booking record; a shared identifier never merges their response fields.
- Endpoint
- POST /api/v1/social
- Capabilities
- 4
- Per 1,000
- $1.389
Available capabilities
Compare the Booking 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 Search public results on Booking. Accepts these parameters: | keyword | check_in, check_out, currency, lang, min_price, property_type, sort, star_rating | Sync delivery | Catalog values: defaultLimit=10, maxLimit=30. 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 · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · score |
profileDetails Retrieve details from Booking. Accepts these parameters: | url | check_in, check_out, currency, lang, min_price, sort, star_rating | Sync delivery | — | $1.39 per 1,000 requests | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · score |
reviewsReviews Retrieve public reviews from Booking. Accepts these parameters: | url | — | 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 · title · text_positive · text_negative · rating · rating_scale · posted_at · stay_date · author_name · author_country · traveler_type · room_name · nights · language · owner_response · platform |
pricesPrices Use the | url | adults, check_in, currency, days, rooms, start_date | Sync delivery | — | $1.39 per 1,000 requests | id · url · hotel_name · room_name · check_in · check_out · price · original_price · discount_percent · currency · taxes_included · is_sold_out · availability_status · rooms_left · min_stay · bed_type · max_guests · room_size_sqm · room_view · meal_plan · is_breakfast_included · is_refundable · rate_options_count · platform |
What does each Booking 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 Booking search parameters mean?
Search public results on Booking. Accepts these parameters: keyword, check_out, star_rating, sort, lang, property_type, currency, check_in, and min_price. Returns these fields: longitude, address, hotel_chain, and text.
keywordRequired- Specifies the property destination name, such as Amsterdam. Used by the search action to find hotels, apartments, and other accommodations, rather than flight, attraction, or review keywords.
check_inOptional- Specifies the check-in date in YYYY-MM-DD format. Search and profile actions require both check_in and check_out to send stay dates. For prices, this acts as the start date when start_date is omitted. Does not create bookings.
check_outOptional- Specifies the check-out date in YYYY-MM-DD format, which must be after check_in and provided together with it. Setting check_out alone will not pass stay ranges to search or profile actions.
currencyOptional- Specifies the currency for property price displays, defaulting to USD. Accepts listed lowercase codes for search and profile actions, and uppercase three-letter codes for prices. This parameter does not change EveryInfra API billing.Allowed values:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langOptional- Specifies the property page display language, defaulting to British English. Accepts engb or enus for British or US English, and zhcn or zhtw for Simplified or Traditional Chinese (do not pass generic en or zh). This parameter does not translate review text.Allowed values:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_priceOptional- Filters properties by a nightly price-range string rather than a single minimum value (for example, 100-150 for a range or 100+ for at least 100). The currency is set by the currency parameter, and total stay prices are not supported.
property_typeOptional- Filters search results by accommodation category, retaining case and spaces (for example, Hotels, Apartments, Hostels, Guest houses, Homestays, Bed and breakfasts, Holiday homes, Boats, Villas, Motels, Resorts, Holiday parks, Campsites, Luxury tents, or none for no restriction). This parameter filters property categories, not specific room types.
sortOptional- Sorts property results by distance relative to location, popular for composite review ranking, or top_rated which maps to star rating rather than guest review score. Search defaults to popular, while profile queries ignore sorting.Allowed values:
distancepopulartop_rated star_ratingOptional- Filters properties by star rating, accepting 1_star through 5_stars, unrated for unrated properties, or any to remove restrictions. Property star ratings are separate from guest review scores.Allowed values:
1_star2_stars3_stars4_stars5_starsanyunratedBooking: Star Ratings, Review Scores, and Quality RatingsBooking maintains separate definitions for property star ratings, guest review scores, and quality ratings. A 1–5 star rating is distinct from a 1–10 guest review score and must not be confused with yellow-block quality ratings.Checked
What do the Booking profile parameters mean?
Retrieve details from Booking. Accepts these parameters: lang, currency, check_out, star_rating, sort, min_price, url, and check_in. Returns these fields: price, rating_scale, breakfast, and text.
urlRequired- Specifies the full URL to a single property page, preferably using the /hotel/ path format. Used by profile to fetch details, reviews to retrieve property reviews, and prices to check room rates. Destination search URLs are not supported.
check_inOptional- Specifies the check-in date in YYYY-MM-DD format. Search and profile actions require both check_in and check_out to send stay dates. For prices, this acts as the start date when start_date is omitted. Does not create bookings.
check_outOptional- Specifies the check-out date in YYYY-MM-DD format, which must be after check_in and provided together with it. Setting check_out alone will not pass stay ranges to search or profile actions.
currencyOptional- Specifies the currency for property price displays, defaulting to USD. Accepts listed lowercase codes for search and profile actions, and uppercase three-letter codes for prices. This parameter does not change EveryInfra API billing.Allowed values:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langOptional- Specifies the property page display language, defaulting to British English. Accepts engb or enus for British or US English, and zhcn or zhtw for Simplified or Traditional Chinese (do not pass generic en or zh). This parameter does not translate review text.Allowed values:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_priceOptional- Filters properties by a nightly price-range string rather than a single minimum value (for example, 100-150 for a range or 100+ for at least 100). The currency is set by the currency parameter, and total stay prices are not supported.
sortOptional- Sorts property results by distance relative to location, popular for composite review ranking, or top_rated which maps to star rating rather than guest review score. Search defaults to popular, while profile queries ignore sorting.Allowed values:
distancepopulartop_rated star_ratingOptional- Filters properties by star rating, accepting 1_star through 5_stars, unrated for unrated properties, or any to remove restrictions. Property star ratings are separate from guest review scores.Allowed values:
1_star2_stars3_stars4_stars5_starsanyunratedBooking: Star Ratings, Review Scores, and Quality RatingsBooking maintains separate definitions for property star ratings, guest review scores, and quality ratings. A 1–5 star rating is distinct from a 1–10 guest review score and must not be confused with yellow-block quality ratings.Checked
What do the Booking reviews parameters mean?
Retrieve public reviews from Booking. Accepts these parameters: url. Returns these fields: text_positive, nights, rating_scale, and owner_response.
urlRequired- Specifies the full URL to a single property page, preferably using the /hotel/ path format. Used by profile to fetch details, reviews to retrieve property reviews, and prices to check room rates. Destination search URLs are not supported.Booking: Guest Reviews and Sub-Category RatingsBooking documentation notes that overall review scores and individual category scores are submitted independently. This references official website framing; review scale dimensions for this API action must still be checked against each input shape, and citing this link does not verify that normalization has been validated.Checked
What do the Booking prices parameters mean?
Use the prices action on Booking. Accepts these parameters: days, check_in, adults, currency, start_date, rooms, and url. Returns these fields: room_view, meal_plan, availability_status, and original_price.
urlRequired- Specifies the full URL to a single property page, preferably using the /hotel/ path format. Used by profile to fetch details, reviews to retrieve property reviews, and prices to check room rates. Destination search URLs are not supported.
adultsOptional- Specifies the adult guest count for price queries, accepting an integer and defaulting to 2. Used as a price query parameter only; does not cap returned room options or initiate a booking. Search operates with a fixed count of 2 adults.
check_inOptional- Specifies the check-in date in YYYY-MM-DD format. Search and profile actions require both check_in and check_out to send stay dates. For prices, this acts as the start date when start_date is omitted. Does not create bookings.
currencyOptional- Specifies the currency for property price displays, defaulting to USD. Accepts listed lowercase codes for search and profile actions, and uppercase three-letter codes for prices. This parameter does not change EveryInfra API billing.
daysOptional- Specifies how many calendar days ahead to query for prices, defaulting to 7 and constrained to 1–30 (values outside this range are clamped). Determines the query date window, not the length of stay for individual room rates.Booking: Rates and Tax ConditionsBooking says accommodation businesses set their rates, while taxes and fees depend on location, room type, and occupancy. Check each rate description for what is included; this action is a query, not a booking or price guarantee.Checked
roomsOptional- Specifies the number of rooms for price queries, accepting an integer and defaulting to 1. Determines the requested room count rather than the number of returned room options. Search operates with a fixed count of 1 room.
start_dateOptional- Specifies the start date for daily price lookups in prices using YYYY-MM-DD format. Overrides check_in when both are provided. Does not represent review posting dates or property opening dates.
How to use the Booking 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":"booking","action":"search","params":{"keyword":"<keyword>"}}'
Booking API questions
What can I retrieve with the Booking API?
Set platform to booking. The current catalog lists search, details, reviews, and prices. These action names identify different Booking objects or views; they are not interchangeable search modes.
Which input starts a Booking `search` request?
Specifies the property destination name, such as Amsterdam. Used by the search action to find hotels, apartments, and other accommodations, rather than flight, attraction, or review keywords. Send it as keyword inside params.
Which fields can Booking `search` return?
Its declared schema includes name, type, text, and stars. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Booking 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.