# Traveloka Hotel Scraper - SEA Hotel Prices & Ratings (`abotapi/traveloka-com-scraper`) Actor

Scrape Traveloka hotels across Singapore, Malaysia, Indonesia, Thailand, Vietnam and the Philippines: nightly prices, star ratings, guest scores, coordinates and photos by city. Paste search or hotel links, and monitor price changes with recurring updates.

- **URL**: https://apify.com/abotapi/traveloka-com-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Stats:** 2 total users, 1 monthly users, 83.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.80 / 1,000 hotel 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Traveloka Hotel Scraper

Pull hotel listings from Traveloka, Southeast Asia's largest travel platform, across its Singapore, Malaysia, Indonesia, Thailand, Vietnam, Philippines and Australia storefronts. Search by city or area, paste Traveloka links, and get structured records: nightly prices in the local currency, star ratings, guest review scores, coordinates, photos and change tracking for recurring monitoring runs.

### Why This Scraper?

- 30+ fields per hotel: price, star rating, guest score out of 10, review count, region, coordinates, photos, facilities.
- Seven storefronts (en-sg, en-my, en-id, en-th, en-vn, en-ph, en-au) with per-market currency handling.
- Two modes: keyword search by city or area, and URL mode for pasted search (spec=) links and hotel detail links.
- Recurring updates: incremental mode remembers what changed between runs (NEW, UPDATED, UNCHANGED, EXPIRED) and can resume an interrupted run.
- Client-side filters for price range, star rating and guest score, plus result sorting.
- Optional detail enrichment from the JSON lane (no page loads): facility codes + labels,
  feature highlights, extra images and UGC ratings merged per row (per-row surcharge).
  Pasted hotel detail links (URL mode) are still read as documents.
- Fail-loud runs: when the site refuses to serve, the run says so instead of returning an empty result set.

### Data You Get

> Sample shape - values are illustrative placeholders, not from a live listing.

| Field | Example value |
|---|---|
| hotelId | `"254056"` |
| name | `"Sample City Hotel"` |
| url | `"https://www.traveloka.com/en-sg/hotel/singapore/sample-city-hotel-254056?checkIn=2026-10-01"` |
| locationName | `"Singapore"` |
| region | `"Sample District, Singapore"` |
| price | `210.0` |
| currency | `"SGD"` |
| starRating | `4.0` |
| guestRating | `8.5` |
| guestRatingLabel | `"Very Good"` |
| numReviews | `18265` |
| latitude | `1.307744` |
| longitude | `103.862695` |
| facilities | `["Wi-Fi in public areas", "Swimming pool"]` |
| imageUrl | `"https://ik.imagekit.io/tvlk/.../asset/000000-0000000000000.jpeg"` |
| market | `"en-sg"` |
| checkInDate | `"2026-10-01"` |
| checkOutDate | `"2026-10-02"` |
| changeType | `"NEW"` |
| changedFields | `["price"]` |
| firstSeenAt | `"2026-01-01T00:00:00Z"` |
| lastSeenAt | `"2026-01-01T00:00:00Z"` |
| features | `["Free cancellation"]` (detail toggle: feature highlights from the static feed) |
| reviews | `[{"author": "…", "rating": 8.0, "date": "2026-09-01", "text": "…"}]` (fetchReviews toggle: guest reviews, newest first, up to maxReviews per hotel, max 1000) |
Billing scales with review volume: 1 surcharge unit per row plus 1 per started block of 10 reviews (10 reviews = 1 unit, 25 = 3, 1000 = 100). |
| address | street-level address; backfilled via coordinates when the feed leaves it empty (detail toggle) |
| description | document-only field, populated only for pasted hotel links (URL mode) |
| address | document-only field, populated only for pasted hotel links (URL mode) |

### How to Use

Search hotels in one city:

```json
{
  "mode": "search",
  "market": "en-sg",
  "locations": ["Singapore"],
  "maxItems": 20
}
```

Search with filters, sorting and multiple cities:

```json
{
  "mode": "search",
  "market": "en-th",
  "locations": ["Bangkok", "Phuket"],
  "checkInDate": "2026-11-01",
  "checkOutDate": "2026-11-03",
  "adults": 2,
  "sortBy": "price-asc",
  "minStarRating": 4,
  "maxPrice": 5000,
  "maxItems": 40
}
```

Walk a pasted Traveloka search link and enrich the results:

```json
{
  "mode": "url",
  "urls": ["https://www.traveloka.com/en-sg/hotel/search?spec=01-10-2026.02-10-2026.1.1.HOTEL_GEO.107493.Singapore.2"],
  "fetchDetails": true,
  "maxItems": 30
}
```

Monitor a scope for changes (recurring schedule):

```json
{
  "mode": "search",
  "market": "en-my",
  "locations": ["Kuala Lumpur"],
  "maxItems": 50,
  "incrementalMode": true,
  "emitUnchanged": false
}
```

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| mode | select | `search` | Search by city, or paste Traveloka links. |
| market | select | `en-sg` | Storefront locale; sets language and currency. |
| locations | stringList | `["Singapore"]` | Cities or areas to walk (search mode). |
| checkInDate | date | tomorrow | Check-in date (YYYY-MM-DD). |
| checkOutDate | date | day after check-in | Check-out date (YYYY-MM-DD). |
| adults | integer | `2` | Adult guests per search. |
| rooms | integer | `1` | Rooms per search. |
| sortBy | select | `popularity` | Result order: popularity, price low to high, price high to low. |
| minPrice / maxPrice | integer | empty | Nightly price window, applied to returned results (client side). |
| minStarRating | integer | `0` | Drop hotels below this star rating (client side). |
| minGuestRating | number | empty | Drop hotels scoring below this out of 10 (client side). |
| urls | stringList | empty | Traveloka search (spec=) links or hotel detail links (URL mode). |
| fetchDetails | boolean | `false` | Read each hotel's own page for description, address and amenities. Bills the detail-enrichment surcharge per successfully read hotel. |
| maxItems | integer | `20` | Maximum records per run; `0` for unlimited. |
| maxPages | integer | `0` | Safety cap on pages per location; `0` for no page cap. |
| resumeFromRunId | string | empty | Continue an interrupted run, skipping already-saved hotels. |
| incrementalMode | boolean | `false` | Only emit new or changed rows on repeated runs of the same scope. |
| stateKey | string | empty | Optional name for the incremental baseline storage. |
| emitUnchanged | boolean | `false` | Also emit (and bill) unchanged rows in incremental mode. |
| emitExpired | boolean | `false` | Also emit (and bill) rows that disappeared in a complete walk. |
| proxy | proxy | Apify residential | The Actor rotates a multi-country residential pool (SG/ID/MY/TH/VN/PH — a fresh exit per attempt) and fails over automatically if every pool exit is refused. Runs without the RESIDENTIAL group (datacenter) are refused by the site and only get the operator's datacenter failover lane when configured. |
| mcpConnectors | array | empty | Optionally pipe results into Notion, Linear, Airtable or another MCP-connected app. |

### Output Example

> Sample shape - values are illustrative placeholders, not from a live listing.

```json
{
  "hotelId": "254056",
  "name": "Sample City Hotel",
  "url": "https://www.traveloka.com/en-sg/hotel/singapore/sample-city-hotel-254056?checkIn=2026-10-01&checkOut=2026-10-02",
  "locationName": "Singapore",
  "region": "Sample District, Singapore",
  "price": 210.0,
  "priceMinor": 21000,
  "currency": "SGD",
  "starRating": 4.0,
  "guestRating": 8.5,
  "guestRatingMax": 10.0,
  "guestRatingLabel": "Very Good",
  "numReviews": 18265,
  "latitude": 1.307744,
  "longitude": 103.862695,
  "facilities": ["Wi-Fi in public areas"],
  "imageUrl": "https://ik.imagekit.io/tvlk/.../asset/000000-0000000000000.jpeg",
  "market": "en-sg",
  "checkInDate": "2026-10-01",
  "checkOutDate": "2026-10-02",
  "changeType": "NEW",
  "changedFields": [],
  "firstSeenAt": "2026-01-01T00:00:00Z",
  "lastSeenAt": "2026-01-01T00:00:00Z"
}
```

With `fetchDetails` enabled, records also carry `description`, `address`, `amenities` and `detailFetched` when the hotel's own page was read successfully.

### Send results into your apps (MCP connectors)

You can optionally send results into the apps you already use through Apify MCP connectors: authorize a connector under Apify, Settings, API & Integrations, then pick it in the `mcpConnectors` input. Notion receives one page per hotel under the page you set in `notionParentPageUrl`; other connectors receive a condensed summary per item (title plus the main fields flattened as text). The connector write is a side-channel: it never changes the dataset, and the complete record always stays in the Apify dataset. Cap the export per run with `maxNotifyListings`.

# Actor input Schema

## `mode` (type: `string`):

Search walks hotel results for the locations below. URL mode pastes Traveloka hotel-search links (with spec=) or hotel detail links; search filters are ignored in URL mode.

## `market` (type: `string`):

Which Traveloka storefront to read. Sets the language and the currency prices are returned in.

## `locations` (type: `array`):

City or area names as you would type them into Traveloka's hotel search box (e.g. Singapore, Bangkok, Kuta). Each location is resolved to Traveloka's internal region id, then its results are walked. Multiple locations are split evenly across your result budget.

## `checkInDate` (type: `string`):

Check-in date (YYYY-MM-DD). Leave empty to default to tomorrow (site time).

## `checkOutDate` (type: `string`):

Check-out date (YYYY-MM-DD). Leave empty to default to the day after check-in.

## `adults` (type: `integer`):

Number of adult guests per search.

## `rooms` (type: `integer`):

Number of rooms per search.

## `sortBy` (type: `string`):

Search-mode sort order requested from the site. Popularity is Traveloka's own default order.

## `minPrice` (type: `integer`):

Drop hotels whose nightly price is below this. Applied to returned results (client side), in the market's currency.

## `maxPrice` (type: `integer`):

Drop hotels whose nightly price is above this. Applied to returned results (client side), in the market's currency.

## `minStarRating` (type: `integer`):

Drop hotels below this star rating (0 = keep all). Applied to returned results (client side).

## `minGuestRating` (type: `number`):

Drop hotels whose guest review score is below this (Traveloka scores out of 10). Applied to returned results (client side); hotels without a score are kept.

## `urls` (type: `array`):

Multi-URL supported. Paste hotel-search links that contain spec= (from a browser search) and/or hotel detail links. Filter-mode fields are ignored; a search link walks forward from its own dates and occupancy.

## `fetchDetails` (type: `boolean`):

Merges the static-content feed into each row: facility codes + labels, feature highlights, extra images and UGC ratings. Each enriched row bills the detail-enrichment surcharge event once; unenriched rows push the base listing and bill nothing extra. URL-pasted hotel pages are still read as documents.

## `fetchReviews` (type: `boolean`):

Adds a reviews array (author, rating, date, text) from the review JSON lane, up to maxReviews per hotel. Rows with fetched reviews bill the detail-enrichment surcharge like other enrichment (1 unit per 10 reviews). Works with fetchDetails on or off.

## `maxReviews` (type: `integer`):

Cap on review rows per hotel when fetchReviews is on. Billing scales with volume: the enrichment surcharge bills 1 unit per row plus 1 unit per started block of 10 reviews (10 reviews = 1 unit, 25 = 3, 1000 = 100) — heavy review pulls bill their transfer.

## `maxItems` (type: `integer`):

The one real cap: maximum hotel records to return per run, across all locations. 0 means unlimited.

## `maxPages` (type: `integer`):

Safety cap on result pages walked per location. 0 (default) means no page cap: the walk follows Max results and the site's own result count.

## `resumeFromRunId` (type: `string`):

ID of an interrupted run of this Actor to continue, skipping hotels already saved by that run. Leave empty for a fresh run. Conflicts with Incremental mode (pick one).

## `incrementalMode` (type: `boolean`):

Recurring monitoring: the Actor remembers hotels it saw on the previous run of the same scope and only emits new or changed ones. Rows carry changeType/changedFields. Unchanged rows are suppressed (set emitUnchanged to also emit and bill them). Conflicts with Resume from run ID.

## `stateKey` (type: `string`):

Name for the storage the incremental baseline is kept under. Leave empty to derive it from your scope (mode, market, locations, dates, occupancy and filters), so different setups never share a baseline.

## `emitUnchanged` (type: `boolean`):

With Incremental mode: also emit (and bill) rows whose fingerprint did not change, marked changeType UNCHANGED.

## `emitExpired` (type: `boolean`):

With Incremental mode: also emit (and bill) rows that were tracked before but no longer appeared in a complete walk, marked changeType EXPIRED. Never fires when the walk was capped, truncated or refused part-way.

## `proxy` (type: `object`):

Premium lane: browses through Apify RESIDENTIAL with a multi-country pool (SG/ID/MY/TH/VN/PH, a fresh exit per attempt) and automatic failover when every pool exit is refused. Runs without the RESIDENTIAL group (datacenter) are refused by the site and fail over only to the operator's datacenter lane when configured. Free plans: remove the group and bring your own proxy.

## `mcpConnectors` (type: `array`):

Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify → Settings → API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write/digest. Leave empty to skip (never changes the dataset output). Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com).

## `notionParentPageUrl` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "market": "en-sg",
  "locations": [
    "Singapore"
  ],
  "adults": 2,
  "rooms": 1,
  "sortBy": "popularity",
  "minStarRating": 0,
  "urls": [
    "https://www.traveloka.com/en-sg/hotel/search?spec=01-10-2026.02-10-2026.1.1.HOTEL_GEO.107493.Singapore.2"
  ],
  "fetchDetails": false,
  "fetchReviews": false,
  "maxReviews": 10,
  "maxItems": 20,
  "maxPages": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "maxNotifyListings": 50
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Singapore"
    ],
    "urls": [
        "https://www.traveloka.com/en-sg/hotel/search?spec=01-10-2026.02-10-2026.1.1.HOTEL_GEO.107493.Singapore.2"
    ],
    "fetchReviews": false,
    "maxReviews": 10,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/traveloka-com-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Singapore"],
    "urls": ["https://www.traveloka.com/en-sg/hotel/search?spec=01-10-2026.02-10-2026.1.1.HOTEL_GEO.107493.Singapore.2"],
    "fetchReviews": False,
    "maxReviews": 10,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/traveloka-com-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Singapore"
  ],
  "urls": [
    "https://www.traveloka.com/en-sg/hotel/search?spec=01-10-2026.02-10-2026.1.1.HOTEL_GEO.107493.Singapore.2"
  ],
  "fetchReviews": false,
  "maxReviews": 10,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call abotapi/traveloka-com-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/traveloka-com-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/mkpNG3fbfqgmIKl9E/builds/yEItJxMaHdMLaNruW/openapi.json