# Agoda Scraper w/ Contact Info (`epicscrapers/agoda-listing-scraper`) Actor
Scrape any Agoda property by hotel ID: amenities, photos, policies, review scores, nearby places, staff languages, and legal operator info (business name, email, phone, registration). 24+ fields. Batch hundreds of IDs. No login or API key needed. Live data every run.
- **URL**: https://apify.com/epicscrapers/agoda-listing-scraper.md
- **Developed by:** [Epic Scrapers](https://apify.com/epicscrapers) (community)
- **Categories:** Travel, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 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
## Agoda Property Details Scraper ⭐
**Pull the complete data profile of any Agoda property — in seconds, at any scale, with no login or API agreement required.**
One hotel ID in. Twenty-four structured fields out: descriptions, amenities, photos, policies, review scores, nearby places, legal information, and more. Works for any property on Agoda, anywhere in the world.
---
### What Makes This Different
Most Agoda scrapers work like a search engine — give them a destination and dates, get back a list of hotels with prices. This scraper does the opposite.
Feed it a hotel ID. Get back everything that lives inside that property's page: the full description, every amenity grouped by category, the complete photo gallery, check-in and check-out policies, children policies, nearby points of interest, per-category review breakdowns, staff languages, legal operator details, and public notes.
This is the data that search scrapers skip. If you need to know what's *inside* a listing — not just that it exists — this is the tool.
---
### What You Get Per Property
**24+ structured fields, live from Agoda on every run:**
| Field | Description |
|---|---|
| `name`, `type`, `starRating` | Property identity |
| `description.short` / `description.long` | Promotional blurb + full HTML-formatted description |
| `summary.coordinates` / `summary.address` | Location with full address, city, country, postal code |
| `amenities.top` / `amenities.grouped` | Top amenities + full list organized by category (internet, parking, dining, services…) |
| `gallery.property.images` + `groups` | Full photo gallery organized by group: property views, rooms, facilities, food |
| `reviews.score`, `scoreText`, `totalCount` | Overall rating with label and review count |
| `reviews.categories` | Per-category scores: Cleanliness, Location, Service, Value for Money, and more |
| `policies` | Children, extra bed, minimum age, check-in/out times, additional rules |
| `highlights.favoriteFeatures` | Structured property highlights, exactly as displayed on Agoda |
| `localInformation.nearbyPlaces` | 10+ nearby places with name, distance in km, and coordinates |
| `usefulInfoGroups` | Check-in/out times, distance to city center, airport travel time, room count, renovation year |
| `languageSpoken` | Languages spoken by staff |
| `legalInformation.traders` | Business name, address, email, phone, registration number of the property operator |
| `notes.publicNotes` / `importantNotes` | Operational constraints and announcements |
| `messaging` | Pre- and post-booking messaging availability |
---
### Built for Real Use Cases
#### Monitor your own portfolio at scale
Managing 50+ properties across multiple countries? Run all your hotel IDs in one batch. Catch stale descriptions, missing amenity categories, outdated policies, and thin photo galleries before guests do — and before they hurt your conversion rate. Schedule it weekly. Get notified when anything changes.
#### Track competitors, not just prices
Price tracking is table stakes. This scraper goes further. Watch competitors' `highlights.favoriteFeatures` to see which selling points they're leading with. Compare `reviews.categories` to find where they're weak — and where they're winning. Spot when they add a new amenity, change their check-out time, or update their description. Know instantly, not after your next manual audit.
#### Fuel content platforms and travel apps
A hotel comparison platform or travel app needs rich structured content — not just names and star ratings. `description.short` gives you the search card blurb. `description.long` fills the detail page. `gallery.property.images` (organized by "Rooms," "Facilities," "Food") lets you serve context-appropriate photos without manual tagging. `localInformation.nearbyPlaces` is a ready-made "Nearby attractions" module. One actor. Your entire content pipeline.
#### Verify operators for compliance
The `legalInformation.traders` field is uniquely powerful for compliance teams. It surfaces the exact business name, registered address, email, phone number, and business registration number of the property operator — instantly, for any property on Agoda. No document requests. No email chains. Just structured data, ready to check against your supplier registry.
#### Screen acquisition targets in minutes
Evaluating a hotel for acquisition? Pull its Agoda profile before the site visit. `reviews.categories` gives you a guest satisfaction baseline. `highlights.favoriteFeatures` reveals what guests actually value (and where the upside might be). `legalInformation.traders` identifies the current operator. What used to take a day of research takes 10 minutes.
#### Power academic and market research
`usefulInfoGroups` surfaces structural attributes — room count, number of floors, renovation year, year opened — that rarely appear in public datasets. `starRating` cross-referenced with `amenities.grouped` enables rigorous amenity analysis across price tiers. `languageSpoken` reveals multilingual staffing patterns. Every field is consistently structured and ready for statistical analysis.
---
### Input
| Parameter | Required | Default | Description |
|---|---|---|---|
| `hotelIds` | ✅ | `[301503]` | One or more Agoda property IDs |
| `languageLocale` | No | `en-us` | Response language: `ja-jp`, `zh-cn`, `de-de`, `fr-fr`, and more |
| `proxy` | No | Apify Residential (US) | Use an EU country proxy to access contact info for EU/UK properties |
#### Example Input
```json
{
"hotelIds": [301503, 21727126],
"languageLocale": "en-us",
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}
````
#### Example Output (abbreviated)
```json
{
"id": 301503,
"name": "easyHotel London Heathrow",
"type": "Hotel",
"starRating": 2,
"description": {
"short": "Get your trip off to a great start with a stay at this property, which offers free Wi-Fi in all rooms.",
"long": "Experience Comfort and Convenience at easyHotel London Heathrow
..."
},
"amenities": {
"top": ["Free Wi-Fi", "Car park", "Front desk [24-hour]", "Restaurants", "Bar"],
"grouped": [
{"text": "Internet", "items": ["Free Wi-Fi in all rooms!", "Free Wi-Fi in public areas"]},
{"text": "Parking", "items": ["Car park", "On-site parking"]}
]
},
"reviews": {
"score": 6.7,
"scoreText": "Good",
"totalCount": 839,
"categories": [
{"name": "Cleanliness", "score": 6.5},
{"name": "Location", "score": 8.0},
{"name": "Value for Money", "score": 7.5}
]
},
"legalInformation": {
"traders": [{
"businessName": "OYO Technology & Hospitality (UK) LTD",
"email": "ota.uk@oyorooms.com",
"phoneNumber": "+442039616450",
"businessRegistrationNumber": "11202796"
}]
}
}
```
***
### vs. Other Agoda Scrapers
| Feature | This Scraper ⭐ | Fast Agoda Scraper | ParseForge Agoda Scraper |
|---|---|---|---|
| Full property description (short + long) | ✅ | ❌ | ❌ |
| Categorized amenities | ✅ | ❌ | ❌ |
| Photo gallery organized by group | ✅ | ❌ | ❌ |
| Check-in/check-out policies | ✅ | ❌ | ❌ |
| Children & extra bed policies | ✅ | ❌ | ❌ |
| Nearby places with distances | ✅ | ❌ | ❌ |
| Review scores with category breakdown | ✅ | Overall only | ❌ |
| Legal & trader information | ✅ | ❌ | ❌ |
| Languages spoken at property | ✅ | ❌ | ❌ |
| Public notes & important notes | ✅ | ❌ | ❌ |
| Distance from city center | ✅ | ❌ | ❌ |
| Price data | ❌ | ✅ | ✅ |
| Search by destination + dates | ❌ | ✅ | ✅ |
> Need price data or destination search instead? See [Fast Agoda Scraper](https://apify.com/epicscrapers/agoda-listing-scraper). Need reviews? See [Agoda Reviews Scraper ⭐](https://apify.com/epicscrapers/agoda-reviews-scraper).
***
### Common Questions
**How do I find a property's Agoda hotel ID?**
It's in the URL. For `agoda.com/easyhotel-london-heathrow/hotel/london-gb.html?hotelId=301503`, the ID is `301503`. You can also inspect the page source or use a browser extension.
**Can I run hundreds of IDs at once?**
Yes. The `hotelIds` field accepts an array — 10, 50, or 500 IDs in a single run. Each property gets its own output record.
**Is the data live or cached?**
Live every time. No cache. Each run sends fresh requests to Agoda, so photo updates, policy changes, and new amenities show up immediately.
**Do I need an account, API key, or partner agreement?**
No. This actor uses publicly available Agoda property data. All you need is an Apify account.
**Can I get data in languages other than English?**
Yes. Set `languageLocale` to `ja-jp`, `zh-cn`, `ko-kr`, `de-de`, `fr-fr`, `es-es`, `th`, or any supported locale. Descriptions, amenity names, and property details return in the requested language where available.
**What about EU/UK contact information?**
Agoda restricts legal contact info for EU/UK properties to users accessing from within the region. Use the proxy configuration with an EU country to access it.
**What export formats are available?**
JSON, CSV, Excel (XLSX), XML, HTML Table, and RSS — directly from the Apify Console or via API. Output can also be piped to Google Sheets, BigQuery, Airtable, or any webhook-compatible system.
**Why not just use the Agoda Partner API?**
The Partner API requires a formal commercial partnership with Agoda, a signed agreement, and a technical integration that can take weeks. It also typically limits access to properties you own or manage — not competitors. This actor is ready in minutes and works for any property on the platform.
***
### Related Scrapers
| Actor | What it does |
|---|---|
| [Agoda Reviews Scraper ⭐](https://apify.com/epicscrapers/agoda-reviews-scraper) | Reviews with traveler type, language, and rating filters |
| [Airbnb Scraper CHEAP](https://apify.com/epicscrapers/airbnb-scraper) | Airbnb listing details for lead gen and market research |
| [Airbnb Reviews Scraper](https://apify.com/epicscrapers/airbnb-reviews-scraper) | Guest reviews and ratings from Airbnb |
| [FlixBus Trip and Prices Scraper](https://apify.com/epicscrapers/flixbus-scraper) | FlixBus schedules and pricing |
| [Google News Scraper](https://apify.com/epicscrapers/google-news-scraper) | Headlines and articles from Google News |
***
*This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Agoda.com, Booking Holdings, or any of their subsidiaries. All trademarks are the property of their respective owners. You are solely responsible for ensuring your use complies with Agoda's Terms of Service and applicable laws.*
# Actor input Schema
## `hotelIds` (type: `array`):
One or more Agoda hotel/property IDs to scrape.
## `languageLocale` (type: `string`):
Language locale for the response (e.g. en-us, ja-jp, zh-cn). Find more here: https://simplelocalize.io/data/locales/
## `proxy` (type: `object`):
Select proxies to be used by your crawler.
## Actor input object example
```json
{
"hotelIds": [
301503
],
"languageLocale": "en-us",
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
```
# Actor output Schema
## `results` (type: `string`):
Link to the dataset of scraped records
# 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 = {
"hotelIds": [
301503
],
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("epicscrapers/agoda-listing-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 = {
"hotelIds": [301503],
"proxy": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US",
},
}
# Run the Actor and wait for it to finish
run = client.actor("epicscrapers/agoda-listing-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 '{
"hotelIds": [
301503
],
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}' |
apify call epicscrapers/agoda-listing-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=epicscrapers/agoda-listing-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Agoda Scraper w/ Contact Info",
"description": "Scrape any Agoda property by hotel ID: amenities, photos, policies, review scores, nearby places, staff languages, and legal operator info (business name, email, phone, registration). 24+ fields. Batch hundreds of IDs. No login or API key needed. Live data every run.",
"version": "0.0",
"x-build-id": "pRyzIzWK9Aucl53Qj"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/epicscrapers~agoda-listing-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-epicscrapers-agoda-listing-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/epicscrapers~agoda-listing-scraper/runs": {
"post": {
"operationId": "runs-sync-epicscrapers-agoda-listing-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/epicscrapers~agoda-listing-scraper/run-sync": {
"post": {
"operationId": "run-sync-epicscrapers-agoda-listing-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",
"required": [
"hotelIds"
],
"properties": {
"hotelIds": {
"title": "Hotel IDs",
"type": "array",
"description": "One or more Agoda hotel/property IDs to scrape.",
"items": {
"type": "string"
}
},
"languageLocale": {
"title": "Language Locale",
"type": "string",
"description": "Language locale for the response (e.g. en-us, ja-jp, zh-cn). Find more here: https://simplelocalize.io/data/locales/",
"default": "en-us"
},
"proxy": {
"title": "Proxy configuration",
"type": "object",
"description": "Select proxies to be used by your crawler."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```