Piloterr

Despegar Hotel Ad

GET
/v2/despegar/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

Authentification

ApiKeyAuth
headerx-api-key<token>

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

Paramètres de requête

query*string

Required. Full Despegar detail URL.

https://www.despegar.com.ar/accommodations/detail/242503/2026-12-15/2026-12-18/2
language?string

Optional. 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-AR
currency?string

Optional. Three letters, for example ARS. Used only when the page does not show a currency. It does not change the URL.

country?string

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

ar
mx

ar 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?boolean

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

false
Defaultfalse
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

Corps de la réponse

Successful response

application/json
  1. response
id?string
url?string
name?string
rooms?array<>
stars?integer
photos?array<string>
rating?number
address?
pricing?
category?string
location?
policies?
amenities?array<string>
thumbnail?string
description?string
rating_label?string
check_in_time?string
reviews_count?integer
check_out_time?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/despegar/ad?query=string'
Example Response
{  "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"}