Goibibo

Return the exact per-room-type price a real guest sees in Goibibo's own app — not a metasearch or commission-inflated affiliate price. Goibibo runs on MakeMyTrip's own backend under a different brand, so this source is resolved and fetched the same way the official Goibibo Android app does. Submit a job, receive a job_id, poll for the result.

Base URL: https://gumo.co.in · Auth: X-API-Key: gsk_… with the ota:goibibo 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": "goibibo",
    "hotel_name": "The Taj Mahal Palace, Mumbai",
    "city": "Mumbai",
    "check_in": "2026-09-15",
    "check_out": "2026-09-17",
    "adults": 2,
    "rooms": 1
  }'

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

Identifying the hotel

A request identifies its hotel one of three ways, exactly as on MakeMyTrip — unsurprising, since the two share a backend.

By name (hotel_name + city) is the default — resolved through Goibibo's own app autosuggest and picked by us. It works without you knowing anything about Goibibo, and is what every existing integration uses.

By Google Place ID (place_id) is the recommended way to pin a portfolio. One id identifies the property across Agoda, Booking.com, MakeMyTrip and Goibibo. The first request for a place still goes through Goibibo's own autosuggest — there's no other way in — but the id that actually returned a price is then pinned, so every later request for that place_id addresses the same property directly. Send hotel_name alongside it if you have it — it's used as the search text for that one resolution; without it we look the name up from the Place ID itself.

By Goibibo's own id (ota_hotel_id, its numeric hotelId, e.g. "201709071828297454") is the fastest and most direct route once you hold it. The whole resolution step disappears, and the answer cannot drift to a different hotel between runs. It is the same id MakeMyTrip uses — if you already have a portfolio of MakeMyTrip hotelIds, they work here unchanged. The id is validated against "ota": "goibibo" at submit, so an id from a different OTA is rejected with 400 before any job is created or billed.

Checking we priced the hotel you meant. Read result.origin_hotel_name — the origin's own name for the property it priced, sourced from the same deeplink field MakeMyTrip's parser always reads. That makes it a genuine statement from the origin, not an echo of your text, even though (see Response schema below) the URL it's read from is never published as source_url on a Goibibo result. result.hotel_name cannot answer this question at all — it is your own search text echoed back, not a confirmation signal.

Device pricing — device_type

device_type is accepted and validated on Goibibo — only desktop or mobile are accepted, anything else 400s — and echoed back on the job envelope, but it has no effect on which prices you get.

Poll for results

Poll the poll_url every ~2 seconds until status is completed or failed. Statuses: pending → processing → completed | failed. Job IDs are scoped to this endpoint — a Google Hotels job ID 404s here, and vice versa.

curl https://gumo.co.in/api/v1/scraper/ota-price/YOUR_JOB_ID/ \
  -H "X-API-Key: gsk_your_api_key"
# Repeat every ~2 s until status is "completed" or "failed"

Response schema

The poll response is a job envelope: id, status, ota, hotel_name, city, ota_hotel_id, place_id, check_in, check_out, adults, children_ages, rooms, currency, device_type, result, error_message, created_at, started_at, completed_at, duration_seconds, bandwidth_kb — the same shape as every other OTA on this endpoint (children_ages is always [] here, since Goibibo rejects a non-empty one at submit). On completion, result holds the pricing object, which nests HotelRoomPricing → room_types[] → offers[].

{
  "id": "a1b2c3d4-...", "status": "completed", "error_message": "",
  "result": {
  "ota": "goibibo",
  "hotel_name": "The Taj Mahal Palace, Mumbai",
  "origin_hotel_name": "The Taj Mahal Palace, Mumbai",
  "hotel_id": "200601010111111111",
  "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": 21800.0, "cheapest_fitting_basis": "per_night_before_taxes",
  "source": "http", "scraped_at": "2026-09-14T12:00:00+00:00",
  "sold_out": false, "error": null, "truncated": false,
  "suppliers": [], "rate_channels": [],
  "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": [], "room_id": "991243155",
      "room_size_sqm": 45.0, "max_guests": 3,
      "offers": [
        {
          "price": 21800.0, "currency": "INR", "price_text": "₹ 21,800",
          "price_basis": "per_night_before_taxes", "price_before_discount": null,
          "board": "Breakfast included", "free_cancellation": true,
          "cancellation_text": "Free cancellation until Sep 13",
          "refundable": true, "occupancy": 2,
          "occupancy_source": "priced", "fits_occupancy": true,
          "badges": [], "rate_token": null,
          "supplier_id": null, "rate_channel_id": null, "device_identity": null,
          "tax_included": true, "tax_amount": 3924.0,
          "meal_plan_code": "CP", "meal_plan_code_raw": "MP_CP",
          "source_url": null, "source_url_scope": null
        }
      ]
    }
  ]
  }
}

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.

Goibibo-specific notes

• Ships disabled by default while it completes its first production soak — contact us to enable it on your environment and key.
• One room per request. A value > 1 is accepted at submit but fails the job, not rejected outright — see the callout under Submit a job.
• No children yet. children_ages is rejected with 400 at submit.
• Currency: INR only.
• Device: ignored — every scrape is the Android app route, regardless of device_type.
• Price basis: always per_night_before_taxes, shared with MakeMyTrip.
• Identity: shares MakeMyTrip's numeric hotelId space — an id you already hold for MakeMyTrip works here unchanged.
• Not offered on Rate Shop. /ota-price/ only, until it has proven itself on single-property jobs, where one failure costs one job rather than a whole shop.
• source_url / source_url_scope are always null — see the callout under Response schema.

Next: Destination Search →