# Agoda Hotels Scraper 🏨 (`shahidirfan/agoda-hotels-scraper`) Actor Extract real-time hotel data from Agoda including prices, availability, reviews & room details. Perfect for market research, rate monitoring & travel analytics. Get structured data instantly. - **URL**: https://apify.com/shahidirfan/agoda-hotels-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Travel, E-commerce, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Agoda Hotels Scraper Extract structured hotel listing data from Agoda search contexts for analysis, monitoring, and travel intelligence workflows. Collect property names, links, ratings, prices, location hierarchy, review signals, and facilities in one clean dataset. Designed for reliable large-scale collection with compact records that exclude empty fields. ### Features - **Hotel listing extraction** — Collects Agoda property listings with pagination support. - **Rich property profiles** — Captures names, URLs, ratings, location details, and property type. - **Price and review signals** — Returns average price, review score, review count, and snippets when available. - **Media and amenity context** — Includes primary image links and facility highlights. - **Clean output records** — Removes null and empty fields from each dataset item. ### Use Cases #### Competitive Rate Intelligence Track hotel pricing and review signals across destinations to benchmark market positioning. #### Destination Supply Monitoring Measure available hotels, category mix, and property quality distribution in targeted cities. #### Travel Product Data Pipelines Feed structured hotel data into recommendation engines, BI dashboards, and reporting tools. #### Hospitality Market Research Analyze location-level hotel trends, accommodation types, and quality indicators over time. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrl` | String | No | `https://www.agoda.com/city/manila-ph.html?ds=RftIdmhrzKRMU0Ha` | Agoda listing URL (city/search/property listing URL). | | `results_wanted` | Integer | No | `20` | Maximum hotel records to save. | | `proxyConfiguration` | Object | No | `{"useApifyProxy": true}` | Proxy settings for higher reliability. | --- ### Output Data Each dataset item may contain the following fields (only non-empty values are saved): | Field | Type | Description | |-------|------|-------------| | `property_id` | Integer | Agoda property identifier. | | `property_name` | String | Primary property display name. | | `property_url` | String | Agoda property page URL. | | `city_name` | String | Property city name. | | `country_name` | String | Property country name. | | `property_type` | String | Property category. | | `star_rating` | Number | Star rating value. | | `average_price` | Number | Average price value. | | `currency` | String | Currency code for price. | | `review_score` | Number | Aggregate review score. | | `review_count` | Integer | Total number of reviews. | | `facility_highlights` | Array | Highlighted property facilities. | | `primary_image_url` | String | Main image URL. | | `top_review_snippet` | String | Sample review snippet when available. | | `source_page` | Integer | Pagination page where record was found. | | `source_url` | String | Input Agoda URL used for the run. | | `scraped_at` | String | ISO timestamp of extraction. | --- ### Usage Examples #### Basic Collection ```json { "startUrl": "https://www.agoda.com/city/manila-ph.html?ds=RftIdmhrzKRMU0Ha", "results_wanted": 20 } ```` #### Search URL Collection ```json { "startUrl": "https://www.agoda.com/search?selectedproperty=55804537&checkIn=2026-04-13&los=1&rooms=1&adults=1&children=0", "results_wanted": 40 } ``` #### Larger Batch with Proxy ```json { "startUrl": "https://www.agoda.com/city/manila-ph.html?ds=RftIdmhrzKRMU0Ha", "results_wanted": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` *** ### Sample Output ```json { "property_id": 5610, "property_name": "The Heritage Hotel Manila", "property_url": "https://www.agoda.com/heritage-hotel/hotel/manila-ph.html", "city_name": "Manila", "country_name": "Philippines", "property_type": "Hotel", "star_rating": 4, "average_price": 136.815555, "currency": "USD", "review_score": 8.1, "review_count": 27583, "facility_highlights": [ "Airport transfer", "Swimming pool", "Fitness center" ], "primary_image_url": "https://pix8.agoda.net/hotelImages/5610/0/68daaf79c238135ba474a0b283ced87e.jpg?ce=3", "top_review_snippet": "Great location and very helpful staff.", "source_page": 1, "source_url": "https://www.agoda.com/search?selectedproperty=55804537&checkIn=2026-04-13&los=1&rooms=1&adults=1&children=0", "scraped_at": "2026-04-04T06:30:00.000Z" } ``` *** ### Tips for Best Results #### Start with a Working Agoda URL - Use valid Agoda URLs that include destination or selected property context. - Keep `startUrl` aligned with your target market and stay period. #### Control Output Volume - Use `results_wanted: 20` for fast checks. - Increase `results_wanted` gradually for larger runs. #### Improve Stability at Scale - Enable proxy usage for larger batches. *** ### Integrations Connect your dataset with: - **Google Sheets** — Quick filtering and reporting. - **Airtable** — Build searchable hotel catalogs. - **Looker Studio** — Visualize market and pricing trends. - **Webhooks** — Push records to custom systems. - **Make** — Orchestrate automated workflows. - **Zapier** — Trigger downstream actions from new data. #### Export Formats - **JSON** — App and integration workflows - **CSV** — Spreadsheet analysis - **Excel** — Stakeholder reporting - **XML** — Legacy system interoperability *** ### Frequently Asked Questions #### Can I collect more than one page of hotels? Yes. The actor paginates automatically until `results_wanted` is reached or limits are hit. #### What if I only know a property URL? Use `startUrl` with a valid Agoda property/search context. The actor resolves city context automatically when possible. #### Why do some fields differ between records? Some Agoda listings have richer metadata than others. Empty values are omitted intentionally. #### Can I run this on a schedule? Yes. You can schedule runs and export fresh datasets on a recurring basis. #### Does it support localization? The actor uses stable default locale/origin/currency settings automatically for consistent output. *** ### Support For issues or feature requests, use the actor support channel in Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Apify Scheduling](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is intended for lawful data collection and analysis. You are responsible for complying with Agoda terms, local regulations, and applicable data-use requirements. # Actor input Schema ## `startUrl` (type: `string`): Any Agoda hotel-listing URL, such as city pages, search pages, or listing/property URLs. ## `results_wanted` (type: `integer`): Maximum number of hotels to save. ## `proxyConfiguration` (type: `object`): Apify proxy settings for better reliability. ## Actor input object example ```json { "startUrl": "https://www.agoda.com/city/manila-ph.html?ds=RftIdmhrzKRMU0Ha", "results_wanted": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "startUrl": "https://www.agoda.com/city/manila-ph.html?ds=RftIdmhrzKRMU0Ha", "results_wanted": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/agoda-hotels-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 = { "startUrl": "https://www.agoda.com/city/manila-ph.html?ds=RftIdmhrzKRMU0Ha", "results_wanted": 20, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/agoda-hotels-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 '{ "startUrl": "https://www.agoda.com/city/manila-ph.html?ds=RftIdmhrzKRMU0Ha", "results_wanted": 20 }' | apify call shahidirfan/agoda-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/agoda-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Agoda Hotels Scraper 🏨", "description": "Extract real-time hotel data from Agoda including prices, availability, reviews & room details. Perfect for market research, rate monitoring & travel analytics. Get structured data instantly.", "version": "1.0", "x-build-id": "TFZNlcwJfcynxTbnB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~agoda-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-agoda-hotels-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/shahidirfan~agoda-hotels-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-agoda-hotels-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/shahidirfan~agoda-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-agoda-hotels-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": { "startUrl": { "title": "Agoda URL", "type": "string", "description": "Any Agoda hotel-listing URL, such as city pages, search pages, or listing/property URLs." }, "results_wanted": { "title": "Maximum Hotels", "minimum": 1, "type": "integer", "description": "Maximum number of hotels to save.", "default": 20 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings for better reliability.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```