Despegar Room Offers
Room offers for one Despegar hotel and one stay. query is the accommodations detail URL, or the numeric hotel id together with check_in, check_out, and adults. status is ok when rooms are returned, no_availability when the night is sold out, and error when the page or the availability call fails. room_name is the Spanish name shown on despegar.com.ar, with nothing appended. room_id is Despegar's room identifier. Each offer can include price_list, price_logged_in, and price_mercado_pago in ARS with taxes included. A price is omitted when the site does not show it. board and cancellation are separate from the room name.
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. Despegar detail URL, or the numeric hotel id. The value sent is the URL or the id, not an API URL.
https://www.despegar.com.ar/accommodations/detail/1612020/2026-12-15/2026-12-16/21612020check_in?stringRequired when query is a hotel id. YYYY-MM-DD, today or later. Send it with check_out.
2026-12-15check_out?stringRequired when query is a hotel id. YYYY-MM-DD, after check_in.
2026-12-16adults?numberOptional. Default 2. Used when query is a hotel id. The detail URL already contains the occupancy.
"2"country?stringOptional. Two-letter site code, for example ar. It does not change the proxy and does not rewrite a detail URL. When query is only a hotel id, ar uses despegar.com.ar and mx uses despegar.com.mx. Any other code returns 400.
arfields?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
body?name?stringstatus?integercurl -X GET 'https://api.piloterr.com/v2/despegar/hotel/rooms?query=string'{ "body": { "rooms": [ { "offers": [ { "board": "All inclusive", "currency": "ARS", "price_list": 320246, "refundable": false, "cancellation": "No podés cancelar ni realizar cambios", "price_logged_in": 252096, "price_mercado_pago": 298213 } ], "room_id": "2779250", "room_name": "Habitación Doble Estándar" } ], "status": "ok", "check_in": "2026-12-15", "currency": "ARS", "hotel_id": "1612020", "check_out": "2026-12-16" }, "name": "Available", "status": 200}