Despegar Hotel Ad
Hotel detail from a Despegar accommodations detail URL. The URL is fetched as-is. country does not rewrite it.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringRequired. Full Despegar detail URL.
https://www.despegar.com.ar/accommodations/detail/242503/2026-12-15/2026-12-18/2language?stringOptional. Default es-AR. Aliases: es, en, pt, ar. If set, it wins over the locale implied by country. The detail URL itself is not rewritten.
es-ARcurrency?stringOptional. Three letters, for example ARS. Used only when the page does not show a currency. It does not change the URL.
country?stringOptional. Two-letter site code. The value sent is the code, for example ar. It does not change the proxy. It selects the site and sends the x-locale header. If language is set, language wins for the locale. A full URL in query is left unchanged. Any other code returns 400.
armxar despegar.com.ar, mx despegar.com.mx, co despegar.com.co, cl despegar.cl, pe despegar.com.pe, uy despegar.com.uy, br decolar.com, us despegar.com.
return_page_source?booleanOptional. Default false. true returns {"result": html} instead of JSON. A Chrome, Brave, or Internet Explorer proxy error is still HTTP 500, and that error page is not returned.
falsefalsefields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
id?stringurl?stringname?stringrooms?array<>stars?integerphotos?array<string>rating?numberaddress?pricing?category?stringlocation?policies?amenities?array<string>thumbnail?stringdescription?stringrating_label?stringcheck_in_time?stringreviews_count?integercheck_out_time?stringcurl -X GET 'https://api.piloterr.com/v2/despegar/ad?query=string'{ "id": "hotel-bsas-22741", "url": "https://www.despegar.com/hoteles/argentina/buenos-aires/alvear-palace-hotel/hotel/22741", "name": "Alvear Palace Hotel", "rooms": [ { "id": "rm-deluxe-classic", "name": "Habitación Deluxe Clásica", "capacity": 2, "price_per_night": 184200, "free_cancellation": false, "breakfast_included": true, "cancellation_deadline": null } ], "stars": 5, "photos": [ "https://photos.despegar.com/hotels/22741/1.jpg", "https://photos.despegar.com/hotels/22741/2.jpg", "https://photos.despegar.com/hotels/22741/3.jpg" ], "rating": 9.3, "address": { "city": "Buenos Aires", "full": "Av. Alvear 1891, Recoleta, Buenos Aires, Argentina", "country": "Argentina", "neighborhood": "Recoleta" }, "pricing": { "taxes": 110520, "currency": "ARS", "total_price": 921000, "price_per_night": 184200, "free_cancellation": false, "breakfast_included": true }, "category": "Lujo", "location": { "lat": -34.5874, "lng": -58.3932 }, "policies": { "parking": "De pago", "pets_allowed": false, "smoking_allowed": false }, "amenities": [ "Wi-Fi gratis", "Restaurante", "Spa", "Gimnasio", "Piscina cubierta", "Concierge 24h", "Centro de negocios" ], "thumbnail": "https://photos.despegar.com/hotels/22741/main.jpg", "description": "El Alvear Palace Hotel es el hotel de lujo más emblemático de Buenos Aires, ubicado en el corazón del barrio de Recoleta. Desde 1932, ofrece una experiencia de hospedaje inigualable con habitaciones elegantes, gastronomía de excelencia y un spa de clase mundial.", "rating_label": "Excelente", "check_in_time": "15:00", "reviews_count": 1874, "check_out_time": "12:00"}