Piloterr

Despegar Room Offers

GET
/v2/despegar/hotel/rooms

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

Autorisierung

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Abfrageparameter

query*string

Required. 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/2
1612020
check_in?string

Required when query is a hotel id. YYYY-MM-DD, today or later. Send it with check_out.

2026-12-15
check_out?string

Required when query is a hotel id. YYYY-MM-DD, after check_in.

2026-12-16
adults?number

Optional. Default 2. Used when query is a hotel id. The detail URL already contains the occupancy.

Default"2"
country?string

Optional. 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.

ar
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
body?
name?string
status?integer
Example Request
curl -X GET 'https://api.piloterr.com/v2/despegar/hotel/rooms?query=string'
Example Response
{  "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}