Hotel Rates — Direct OTA

Return the exact per-room-type price a real guest sees on an OTA's own site — for Agoda, Booking.com and MakeMyTrip — normalized into a single schema so you can compare them field-for-field. Like the other scrapers, this is an async job: submit, receive a job_id, poll for the result.

Base URL: https://gumo.co.in · Auth: X-API-Key: gsk_… (same key as Google Hotels; the key needs the matching ota:<name> scope) · See the Overview.

Submit a job

curl -X POST https://gumo.co.in/api/v1/scraper/ota-price/ \
  -H "X-API-Key: gsk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "ota": "agoda",
    "hotel_name": "The Taj Mahal Palace, Mumbai",
    "city": "Mumbai",
    "check_in": "2026-09-15",
    "check_out": "2026-09-17",
    "adults": 2,
    "rooms": 1,
    "currency": "INR"
  }'

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending",
  "ota": "agoda",
  "poll_url": "/api/v1/scraper/ota-price/a1b2c3d4-e5f6-7890-abcd-ef1234567890/"
}

Poll for results

Poll the poll_url every ~2 seconds until status is completed or failed. Statuses: pending → processing → completed | failed. Google Hotels job IDs 404 here (and OTA job IDs 404 on the Google poll endpoint) — each scraper polls its own jobs.

Response schema

The poll response is a job envelope: id, status, ota, hotel_name, city, check_in, check_out, adults, rooms, currency, result, error_message, created_at, started_at, completed_at, duration_seconds, bandwidth_kb. On completion, result holds the pricing object, which nests HotelRoomPricing → room_types[] → offers[], identical across all three OTAs.

{
  "id": "a1b2c3d4-...", "status": "completed", "error_message": "",
  "result": {
  "ota": "agoda",
  "hotel_name": "The Taj Mahal Palace, Mumbai",
  "hotel_id": "16082488",
  "currency": "INR",
  "check_in": "2026-09-15", "check_out": "2026-09-17",
  "adults": 2, "rooms": 1,
  "nights": 2, "adults_per_room": 2, "price_scope": "per_room",
  "occupancy_honored": true,
  "cheapest_fitting_price": 22500.0, "cheapest_fitting_basis": "per_night_before_taxes",
  "source": "http", "scraped_at": "2026-09-01T12:00:00+00:00",
  "sold_out": false, "error": null, "truncated": false,
  "room_types": [
    {
      "name": "Luxury Room Palace Wing", "sold_out": false,
      "room_size": "45 m²", "bed": "1 king bed", "view": "City view",
      "amenities": ["Free WiFi", "Parking"], "images": ["https://..."],
      "tags": ["free-cancellation", "king-bed"], "room_id": "991243155",
      "room_size_sqm": 45.0, "max_guests": 3,
      "offers": [
        {
          "price": 22500.0, "currency": "INR", "price_text": "₹ 22,500",
          "price_basis": "per_night_before_taxes", "price_before_discount": null,
          "board": "Breakfast included", "free_cancellation": true,
          "cancellation_text": "Cancel for free before Sep 13, 2026",
          "refundable": true, "occupancy": 2,
          "occupancy_source": "priced", "fits_occupancy": true,
          "badges": ["Lowest price available!"], "rate_token": "8b:0;c:2D1N_100P;..."
        }
      ]
    }
  ]
  }
}

Object fields

Result outcomes

Submitting can 4xx (validation 400, auth 401, missing scope 403, throttling 429). Once a job is accepted, polling always returns HTTP 200 — you distinguish scrape outcomes by fields, never by status code:

A scrape failure is never a 4xx/5xx on the poll — it is a failed job with an explanation.

Agoda

Set "ota": "agoda". Resolved and fetched over pure HTTP. Requires the ota:agoda key scope.

• Currencies: INR, USD, GBP, EUR, AED.
• Price basis: usually per_night_before_taxes, derived per offer from Agoda's own price label — always read the field.
• Full room grid with room size, bed, view, amenities and per-offer cancellation terms.

Booking.com

Set "ota": "booking" (alias booking.com). Requires the ota:booking key scope.

• Currencies: INR, USD, GBP, EUR, AED.
• Price basis: total_stay or total_stay_before_taxes (depending on whether Booking shows a taxes-and-charges line) — the total for the whole stay, not per-night. Normalize before comparing with Agoda/MMT.

MakeMyTrip (MMT)

Set "ota": "makemytrip" (aliases mmt, makemytrip.com). Requires the ota:makemytrip key scope.

• Currency: INR only — other codes are rejected rather than mislabeled.
• Price basis: per_night_before_taxes.
• Distinguishes genuine no-availability (returns sold_out: true) from property errors.

Back to: Overview · Google Hotels · Google Flights