Hotel Pricing API Reference

X-API-Key: gsk_your_api_key_here

import time
import requests

API_BASE = "https://gumo.co.in/api/v1/scraper"
API_KEY = "gsk_your_key_here"
HEADERS = {"X-API-Key": API_KEY}

# Submit job with Place ID (deterministic, fast)
response = requests.post(f"{API_BASE}/scrape/", json={
    "hotel_name": "Taj Mahal Palace",
    "place_id": "ChIJbSFzZEzO5zsRgHj0KiJfcoA",
    "check_in": "2026-08-01",
    "check_out": "2026-08-03",
}, headers=HEADERS)

job_id = response.json()["job_id"]

# Poll for results
while True:
    result = requests.get(f"{API_BASE}/scrape/{job_id}/", headers=HEADERS).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(2)

# Use results
if result["status"] == "completed":
    for ota in result["result"]["pricing"]:
        print(f"{ota['platform_name']}: {ota['price_display']}")

# Submit batch — mix of Place ID and name-based lookups
response = requests.post(f"{API_BASE}/batch/", json={
    "check_in": "2026-08-01",
    "check_out": "2026-08-03",
    "hotels": [
        {"hotel_name": "Rambagh Palace", "place_id": "ChIJm14which9bDkRXF7ciSSR4eA"},
        {"hotel_name": "Taj Lake Palace", "city": "Udaipur"},
    ]
}, headers=HEADERS)

job_ids = [j["job_id"] for j in response.json()["jobs"]]

# Poll all at once after waiting
time.sleep(5)
results = requests.post(f"{API_BASE}/batch/results/", json={
    "job_ids": job_ids
}, headers=HEADERS).json()

for job in results["results"]:
    print(f"\n{job.get('hotel_name')} ({job['status']}):")
    if job["result"]:
        for ota in job["result"].get("pricing", [])[:3]:
            print(f"  {ota['platform_name']}: {ota['price_display']}")

# Submit with Place ID
curl -X POST https://gumo.co.in/api/v1/scraper/scrape/ \
  -H "X-API-Key: gsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"hotel_name":"Rambagh Palace","place_id":"ChIJm14which9bDkRXF7ciSSR4eA","check_in":"2026-08-01","check_out":"2026-08-03"}'

# Poll result
curl https://gumo.co.in/api/v1/scraper/scrape/JOB_ID_HERE/ \
  -H "X-API-Key: gsk_your_key"

curl -X POST "https://places.googleapis.com/v1/places:searchText" \
  -H "Content-Type: application/json" \
  -H "X-Goog-Api-Key: YOUR_GOOGLE_API_KEY" \
  -H "X-Goog-FieldMask: places.id" \
  -d '{"textQuery": "Rambagh Palace Jaipur hotel", "maxResultCount": 1}'

# Response:
# {"places": [{"id": "ChIJm14which9bDkRXF7ciSSR4eA"}]}