Primeros pasos

Tu API key

Obtén tu API key desde el panel, en la sección de API Keys. Cada request autenticado va con un header Authorization: Bearer <tu_api_key>.

Tu primer request

curl "https://api.rateshooter.com/v1/quotes?hotel_id=2008&checkin=2026-12-10&checkout=2026-12-11&adults=2" \
  -H "Authorization: Bearer <tu_api_key>"

{
  "status": "ok",
  "hotel": {
    "resolved_name": "Grand Oasis Cancun",
    "hotel_id": 2008,
    "verified": true
  },
  "offers": [
    {
      "vendor": "The Grand Oasis Cancun - All Inclusive",
      "price_per_night": 245.40494,
      "total_price": 245.40494,
      "taxes_included": true
    },
    {
      "vendor": "Super.com",
      "price_per_night": 185.50781,
      "total_price": 185.50781,
      "taxes_included": true
    },
    {
      "vendor": "trivago DEALS",
      "price_per_night": 189.47403,
      "total_price": 189.47403,
      "taxes_included": true
    },
    {
      "vendor": "Traveluro",
      "price_per_night": 187.65692,
      "total_price": 187.65692,
      "taxes_included": true
    },
    {
      "vendor": "Billabook.com",
      "price_per_night": 210,
      "total_price": 210,
      "taxes_included": true
    },
    {
      "vendor": "goseek.com",
      "price_per_night": 219.50781,
      "total_price": 219.50781,
      "taxes_included": true
    },
    {
      "vendor": "Despegar",
      "price_per_night": 301.375,
      "total_price": 301.375,
      "taxes_included": true
    },
    {
      "vendor": "Expedia.mx",
      "price_per_night": 302.93268,
      "total_price": 302.93268,
      "taxes_included": true
    },
    {
      "vendor": "Agoda",
      "price_per_night": 230.1875,
      "total_price": 230.1875,
      "taxes_included": true
    },
    {
      "vendor": "Booking.com",
      "price_per_night": 297.90625,
      "total_price": 297.90625,
      "taxes_included": true
    },
    {
      "vendor": "Priceline",
      "price_per_night": 305.90625,
      "total_price": 305.90625,
      "taxes_included": true
    },
    {
      "vendor": "Evendo",
      "price_per_night": 256.15396,
      "total_price": 256.15396,
      "taxes_included": true
    },
    {
      "vendor": "Central de Reservas",
      "price_per_night": 247.38129,
      "total_price": 247.38129,
      "taxes_included": true
    },
    {
      "vendor": "Hotel prive",
      "price_per_night": 292.5,
      "total_price": 292.5,
      "taxes_included": true
    },
    {
      "vendor": "Hoteles.com",
      "price_per_night": 302.93268,
      "total_price": 302.93268,
      "taxes_included": true
    },
    {
      "vendor": "Qantas Hotels",
      "price_per_night": 302.1284,
      "total_price": 302.1284,
      "taxes_included": true
    },
    {
      "vendor": "klook",
      "price_per_night": 235.61737,
      "total_price": 235.61737,
      "taxes_included": true
    },
    {
      "vendor": "Clicktrip.com",
      "price_per_night": 241.47806,
      "total_price": 241.47806,
      "taxes_included": true
    }
  ],
  "meta": {
    "offers_count": 18,
    "billable": true
  },
  "stay": {
    "checkin": "2026-12-10",
    "checkout": "2026-12-11",
    "nights": 1,
    "adults": 2,
    "rooms": 1,
    "children": [],
    "currency": "USD"
  }
}

Leyendo la respuesta

hotel.hotel_id es el identificador que debes guardar y reutilizar — ver buenas prácticas.
offers trae una entrada por canal con oferta; price_per_night siempre incluye impuestos.
El header X-Request-Id identifica esta llamada específica — tenlo a la mano si necesitas soporte.

Qué sigue

Para cotizar un hotel a la vez: cotización simple.
Para varios hoteles en una llamada: cotización múltiple.
Para entender los códigos de error: errores y límites.