# OYO Rooms Scraper (`solidcode/oyorooms-scraper`) Actor \[💰 $1.60 / 1K] Search OYO Rooms and extract hotel listings at scale — names, prices, discounts, star ratings, amenities, images, and GPS coordinates. Search by city or paste OYO URLs; filter by dates, rooms, and guests across 13 country markets. - **URL**: https://apify.com/solidcode/oyorooms-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Travel, E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.60 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## OYO Rooms Scraper Pull OYO Rooms hotel inventory at scale — names, live nightly prices, original-vs-discounted rates, star ratings, GPS coordinates, amenities, and photos for every property in a city. Search by city name or paste an OYO listing URL, set your dates, and get one clean row per hotel across 13 country markets. Built for travel-tech teams, OTAs, price-comparison builders, and hospitality market researchers who need structured OYO pricing and inventory without hand-collecting it listing by listing. ### Why This Scraper? - **13 country markets in one actor** — India, Indonesia, Malaysia, UAE, United Kingdom, USA, Philippines, Thailand, Vietnam, Nepal, Japan, Mexico, and Brazil, selected from a single dropdown. - **Date-aware live pricing** — set check-in and check-out dates so every returned `price` reflects real availability for that stay, not a stale placeholder rate. - **Original vs. discounted price with the exact discount** — each hotel carries `price`, the pre-discount `slashedPrice`, and the `discountPercentage`, so you can measure OYO's real markdown on every property. - **GPS coordinates on every hotel** — `latitude` and `longitude` for each property, ready to plot on a map or run distance queries without geocoding addresses yourself. - **Full rating breakdown** — numeric `rating`, `ratingCount` (how many guests scored it), and a `ratingLevel` band like "Very Good" on every listing. - **Complete amenities list per hotel** — the `amenities` array carries every named facility (AC, WiFi, breakfast, parking, and more) for each property. - **Multiple photo URLs per hotel** — the `images` array delivers direct links to each property's gallery shots, ready to embed. - **OYO Wizard loyalty flag** — a boolean `oyoWizard` field marks whether each property is eligible for OYO's Wizard loyalty program. - **Sold-out status and external booking link** — `isSoldOut` tells you what's actually bookable for your dates, and `externalBookingUrl` captures the off-platform booking link when present. ### Use Cases **Price Intelligence** - Track OYO's discount depth by comparing `slashedPrice` against `price` across a city - Monitor nightly rates for the same properties across different check-in dates - Benchmark OYO pricing against other budget-hotel chains in the same market - Detect surge pricing around holidays and events by re-running with different dates **Travel Tech & OTA** - Feed live OYO inventory and pricing into a metasearch or comparison site - Build map-based hotel finders using per-property `latitude` and `longitude` - Surface amenity and photo data for property cards in your own booking flow - Flag sold-out properties in real time using the `isSoldOut` field **Market Research** - Map OYO's footprint and property density city by city across 13 countries - Compare average ratings and rating volume between neighborhoods and markets - Analyze category mix (Townhouse, Flagship, and other tiers) in a given city - Study how OYO Wizard loyalty eligibility varies across a market **Lead Generation & Competitive Analysis** - Build a directory of OYO properties with addresses and coordinates for a region - Identify low-rated or high-discount properties as outreach or acquisition targets - Track which properties enter or leave a market over repeated runs - Assemble competitor property lists for hospitality sales teams ### Getting Started #### Search a Single City The simplest run — just one location: ```json { "location": ["Bangalore"], "maxResults": 50 } ```` #### City With Dates and Occupancy Pin your stay so the prices returned match real availability: ```json { "location": ["Gurgaon"], "checkInDate": "2026-08-15", "checkOutDate": "2026-08-17", "rooms": 1, "guests": 2, "maxResults": 100 } ``` #### Multiple Cities in Another Market Search several cities in a non-India market at once: ```json { "location": ["Kuala Lumpur", "Penang"], "country": "malaysia", "maxResults": 300 } ``` #### Paste an OYO Listing URL Pin an exact OYO search page — every filter and page number in the URL is respected: ```json { "startUrls": ["https://www.oyorooms.com/in/hotels-in-jaipur/"], "maxResults": 100 } ``` ### Input Reference #### What to Search | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `location` | string\[] | `["Bangalore"]` | City or location names to search, such as "Bangalore", "Gurgaon", or "Jakarta". Each entry runs its own search. | | `startUrls` | string\[] | `[]` | Paste OYO search or city-listing page URLs directly. Any page number and filters in the URL are respected. Use instead of, or alongside, locations. | #### Stay Details | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `checkInDate` | string | `null` | Check-in date in YYYY-MM-DD format. Prices depend on your dates. Leave blank to use OYO's default upcoming dates. | | `checkOutDate` | string | `null` | Check-out date in YYYY-MM-DD format. Must be after the check-in date. | | `rooms` | integer | `1` | Number of rooms for the stay (1–30). | | `guests` | integer | `2` | Number of guests for the stay (1–90). | #### Market & Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `country` | select | `India` | OYO market to search: India, Indonesia, Malaysia, United Arab Emirates, United Kingdom, United States, Philippines, Thailand, Vietnam, Nepal, Japan, Mexico, or Brazil. | | `maxResults` | integer | `100` | Maximum number of hotels to return across all searches. Set to 0 for unlimited (a safety cap still applies). | | `ignoreUrlFailures` | boolean | `true` | Keep running if a single location or URL fails, instead of stopping the whole run. | ### Output Each hotel is returned as one flat row. Here's a representative result: ```json { "name": "Townhouse Oak Grand Residency", "id": "299164", "url": "https://www.oyorooms.com/in/299164/", "address": "12 MG Road, Ashok Nagar, Bangalore", "city": "Bangalore", "country": "India", "latitude": 12.9716, "longitude": 77.5946, "rating": 4.3, "ratingCount": 1267, "ratingLevel": "Very Good", "category": "Townhouse", "propertyTag": "Couple Friendly", "price": 1499, "slashedPrice": 2998, "discountPercentage": 50, "currency": "₹", "isSoldOut": false, "amenities": ["AC", "TV", "Free WiFi", "Power backup", "Geyser"], "images": [ "https://images.oyoroomscdn.com/uploads/hotel_image/299164/example1.jpg", "https://images.oyoroomscdn.com/uploads/hotel_image/299164/example2.jpg" ], "oyoWizard": true, "externalBookingUrl": null, "searchLocation": "Bangalore", "sourceUrl": "https://www.oyorooms.com/in/hotels-in-bangalore/" } ``` #### Core Fields | Field | Type | Description | |-------|------|-------------| | `name` | string | Hotel name | | `id` | string | OYO hotel identifier | | `url` | string | Canonical OYO hotel page URL | | `category` | string | Property tier (Townhouse, Flagship, and other categories) | | `propertyTag` | string | Marketing label such as "Couple Friendly" | | `isSoldOut` | boolean | Whether the property is sold out for your dates | | `externalBookingUrl` | string | Off-platform booking link when present | #### Location | Field | Type | Description | |-------|------|-------------| | `address` | string | Street address | | `city` | string | City name | | `country` | string | Country name | | `latitude` | number | GPS latitude | | `longitude` | number | GPS longitude | #### Pricing | Field | Type | Description | |-------|------|-------------| | `price` | number | Current booking price for your dates | | `slashedPrice` | number | Original price before the discount | | `discountPercentage` | number | Discount percent off the original price | | `currency` | string | Currency symbol for the market | #### Ratings, Media & Amenities | Field | Type | Description | |-------|------|-------------| | `rating` | number | Overall guest rating value | | `ratingCount` | number | Number of guest ratings | | `ratingLevel` | string | Rating band such as "Very Good" | | `amenities` | string\[] | Named facilities for the property | | `images` | string\[] | Direct URLs to property photos | | `oyoWizard` | boolean | OYO Wizard loyalty-program eligibility | #### Run Context | Field | Type | Description | |-------|------|-------------| | `searchLocation` | string | The location query this row came from | | `sourceUrl` | string | The search/listing URL this row was extracted from | ### Tips for Best Results - **Always set check-in and check-out dates for accurate prices** — OYO's rates are date-sensitive, so a run with no dates returns generic upcoming-date pricing rather than the true cost for your stay. - **Match the country to your city** — searching "Jakarta" with `country` set to Indonesia routes to the correct market; leaving it on India can return no results for a foreign city. - **Use `startUrls` to pin an exact filtered search** — if you've already narrowed a search on OYO's site, paste that URL and every filter plus the page number is honored precisely. - **Start small, then scale** — set `maxResults` to 20–50 on your first run to confirm the data fits your needs, then raise it. Popular cities carry hundreds of properties. - **Combine cities in one run** — list several locations in `location` to sweep an entire region in a single run instead of one run per city. - **Compare `slashedPrice` to `price` for real markdowns** — the gap between them, together with `discountPercentage`, is the most reliable signal of how aggressively a property is discounted. - **Keep `ignoreUrlFailures` on for large batches** — one misspelled city or dead URL then skips gracefully instead of ending the whole run. ### Pricing **From $1.60 per 1,000 results** — a flat pay-per-result rate that undercuts other OYO scrapers on the market. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows the total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.19 | $0.18 | $0.17 | $0.16 | | 1,000 | $1.90 | $1.80 | $1.70 | $1.60 | | 10,000 | $19.00 | $18.00 | $17.00 | $16.00 | | 100,000 | $190.00 | $180.00 | $170.00 | $160.00 | No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. A "result" is any hotel row in the output dataset. Platform fees depend on your Apify plan. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate travel research, price intelligence, and market analysis. You are responsible for complying with applicable laws and OYO's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and handle any collected data responsibly. # Actor input Schema ## `location` (type: `array`): City or location names to search on OYO, such as 'Bangalore', 'Gurgaon', or 'Jakarta'. Each entry runs its own search. Leave empty if you are pasting URLs below. ## `startUrls` (type: `array`): Optional. Paste OYO search or city-listing page URLs directly (for example a 'hotels in ...' page). Any page number in the URL is respected. Use this instead of, or alongside, locations. ## `checkInDate` (type: `string`): Check-in date in YYYY-MM-DD format. Prices depend on your dates. Leave blank to use OYO's default upcoming dates. ## `checkOutDate` (type: `string`): Check-out date in YYYY-MM-DD format. Must be after the check-in date. ## `rooms` (type: `integer`): Number of rooms for the stay. ## `guests` (type: `integer`): Number of guests for the stay. ## `country` (type: `string`): Which OYO market to search in. ## `maxResults` (type: `integer`): Maximum number of hotels to return across all searches. Set to 0 for unlimited (a safety cap still applies). ## `ignoreUrlFailures` (type: `boolean`): Keep running if a single location or URL fails, instead of stopping the whole run. ## Actor input object example ```json { "location": [ "Bangalore" ], "startUrls": [], "rooms": 1, "guests": 2, "country": "india", "maxResults": 100, "ignoreUrlFailures": true } ``` # Actor output Schema ## `overview` (type: `string`): Table of hotels with key fields like name, rating, price, city, and link. ## `details` (type: `string`): Full per-hotel rows including amenities, images, discounts, and coordinates. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": [ "Bangalore" ], "startUrls": [], "checkInDate": "", "checkOutDate": "", "rooms": 1, "guests": 2, "country": "india", "maxResults": 100, "ignoreUrlFailures": true }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/oyorooms-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": ["Bangalore"], "startUrls": [], "checkInDate": "", "checkOutDate": "", "rooms": 1, "guests": 2, "country": "india", "maxResults": 100, "ignoreUrlFailures": True, } # Run the Actor and wait for it to finish run = client.actor("solidcode/oyorooms-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "location": [ "Bangalore" ], "startUrls": [], "checkInDate": "", "checkOutDate": "", "rooms": 1, "guests": 2, "country": "india", "maxResults": 100, "ignoreUrlFailures": true }' | apify call solidcode/oyorooms-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/oyorooms-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OYO Rooms Scraper", "description": "[💰 $1.60 / 1K] Search OYO Rooms and extract hotel listings at scale — names, prices, discounts, star ratings, amenities, images, and GPS coordinates. Search by city or paste OYO URLs; filter by dates, rooms, and guests across 13 country markets.", "version": "1.0", "x-build-id": "U7ycABbuih6M1edse" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~oyorooms-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-oyorooms-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~oyorooms-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-oyorooms-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~oyorooms-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-oyorooms-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "location": { "title": "Locations", "type": "array", "description": "City or location names to search on OYO, such as 'Bangalore', 'Gurgaon', or 'Jakarta'. Each entry runs its own search. Leave empty if you are pasting URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Listing URLs", "type": "array", "description": "Optional. Paste OYO search or city-listing page URLs directly (for example a 'hotels in ...' page). Any page number in the URL is respected. Use this instead of, or alongside, locations.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in Date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Prices depend on your dates. Leave blank to use OYO's default upcoming dates." }, "checkOutDate": { "title": "Check-out Date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Must be after the check-in date." }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms for the stay.", "default": 1 }, "guests": { "title": "Guests", "minimum": 1, "maximum": 90, "type": "integer", "description": "Number of guests for the stay.", "default": 2 }, "country": { "title": "Country", "enum": [ "india", "indonesia", "malaysia", "uae", "united-kingdom", "usa", "philippines", "thailand", "vietnam", "nepal", "japan", "mexico", "brazil" ], "type": "string", "description": "Which OYO market to search in.", "default": "india" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of hotels to return across all searches. Set to 0 for unlimited (a safety cap still applies).", "default": 100 }, "ignoreUrlFailures": { "title": "Continue on Errors", "type": "boolean", "description": "Keep running if a single location or URL fails, instead of stopping the whole run.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```