# Klook Search Scraper (`romy/klook-search-scraper`) Actor

Get full-text search across every Klook vertical from Klook. Talks directly to Klook's own mobile app API, no login needed. Split from the mature, published klook-all-in-one-api for a focused, single-purpose workflow.

- **URL**: https://apify.com/romy/klook-search-scraper.md
- **Developed by:** [Romy](https://apify.com/romy) (community)
- **Categories:** Travel
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 search result chargeds

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

### What does Klook Search Scraper do?

**Klook Search Scraper** runs full-text activity/experience search across every Klook vertical (Tours, Attractions, Transport, Hotels, More) with the app's entire real filter panel — main/branch category, dates, guided language, services, departure time, duration, minimum review score, price range, and more. It also exposes the search screen's init state, as-you-type suggestions, and the live filter schema as separate modes.

It talks directly to the same internal API the official [Klook](https://www.klook.com/) Android app uses, reverse-engineered by disassembling the app's native request-signing library and validated against live traffic captured from a real device. No Klook account, no API key. This is the search slice of [Klook All-in-One API](https://apify.com/romy/klook-all-in-one-api), split out as its own focused Actor.

### Why use Klook Search Scraper?

- **Every real search filter** — every param below was confirmed live by the parent Actor by tapping the actual control in the app's Filters dialog and reading the resulting request off the wire, not guessed
- **Every vertical, not just activities** — `mainCategory=30` (Transport) returns real Tokyo subway/Shinkansen tickets, `mainCategory=54` (Hotels) returns real bookable listings, through the exact same endpoint
- **Real, working pagination** — confirmed live with real result counts and zero id overlap across pages
- **No account needed** — every mode works fully anonymously
- **Use cases:** activity discovery bots, price/rating monitoring, category-id/filter-id discovery via `filters` mode, as-you-type search UX prototyping via `suggest` mode

### How it connects to the parent

This Actor is a narrow, batch-run spin-off of [klook-all-in-one-api](https://apify.com/romy/klook-all-in-one-api) (an always-on Standby REST API exposing every Klook endpoint). It reuses the parent's exact, proven request-signing logic (`klook-client.ts`, copied verbatim) but only wraps `/search/init`, `/search/suggest`, `/search`, and `/search/filters`, and runs as a normal input-in/dataset-out Actor instead of a Standby API.

### Input

| Field                   | Type          | Description                                                                                                              |
| ----------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `mode`                  | string        | `search` (default, paginated) | `suggest` | `init` | `filters`                                                        |
| `query`                 | string        | **Required for search/suggest/filters.** Search text                                                                     |
| `start`                 | integer       | 1-indexed result offset for `mode=search`. Default `1`                                                                   |
| `size`                  | integer       | Results per page for `mode=search`. Default `10`                                                                         |
| `maxPages`              | integer       | Stop after this many pages (`mode=search`). Default `10`                                                                 |
| `maxItems`              | integer       | Stop once this many results have been pushed (`mode=search` only)                                                        |
| `sort`                  | enum          | `most_relevant` | `price` | `participants` | `publish_time` | `review_score`                                         |
| `date`                  | string (date) | `YYYY-MM-DD` — a single date, not a real range                                                                           |
| `mainCategory`          | string        | `1`=Tours & experiences, `2`=Attraction tickets, `30`=Transport, `54`=Hotels, `70`=More. Also the tab for `mode=filters` |
| `branchCategory`        | string        | Sub-category id — see `klook-categories-scraper` or `mode=filters`                                                       |
| `guidedLanguage`        | string        | Tour guide language id, e.g. `3029`=English guided                                                                       |
| `services`              | string\[]      | Small group, hotel pick-up, free cancellation, guaranteed departure, ...                                                 |
| `departureTime`         | string\[]      | Evening/afternoon departure, ...                                                                                         |
| `duration`              | string\[]      | 0-3 hours, 3-5 hours, full day, 2+ days, ...                                                                             |
| `reviewScore`           | string        | `3`, `3.5`, `4`, or `4.5`                                                                                                |
| `priceMin` / `priceMax` | number        | Price range                                                                                                              |
| `other`                 | string\[]      | `other_instant_key`=Instant confirmation, `36822`=Halal-friendly                                                         |
| `location`              | string        | Narrow results to a location id, e.g. `1012`=Japan                                                                       |
| `currency`              | string        | ISO code, default `GBP`                                                                                                  |

Example:

```json
{ "mode": "search", "query": "tokyo", "mainCategory": "1", "sort": "price", "size": 10 }
```

### Output

One row per search result for `mode=search`. Real example (from the parent Actor's own live-confirmed capture of `GET /search?query=tokyo&main_category=1&sort=price&size=1`):

```json
{
    "data": {
        "city_id": 28,
        "title": "Tokyo Chopstick Making Experience in Ginza",
        "deep_link": "https://www.klook.com/en-GB/activity/183178-tokyo-chopstick-making-experience-in-ginza/"
    }
}
```

For `mode=init`/`suggest`/`filters`, one row wrapping the raw response: `{ "mode": "...", "data": { ... } }`.

### Known limitations

- **Requires Apify's RESIDENTIAL proxy group.** Klook's edge blocks non-residential IPs with a DataDome bot-challenge page — confirmed directly from this development sandbox (a request byte-for-byte identical to a working one, sent without the proxy, came back as a DataDome JS-challenge HTML page, not JSON). All outbound requests route through `Actor.createProxyConfiguration({ groups: ['RESIDENTIAL'] })`.
- **Local dev smoke testing outside the Apify platform needs "Proxy external access" enabled on the account.** This Actor's code was verified to be a byte-for-byte match against the parent's already-published, working `klook-client.ts`, and the local smoke test run during development failed exactly at the proxy-URL-acquisition step (`ProxyConfiguration: The "Proxy external access" feature isn't enabled for your account`) — before any request to Klook was even attempted. That's an account-tier restriction on pulling a proxy URL from *outside* a real platform Actor run, not a defect in this code; once deployed and actually run on Apify's platform, proxy access works through the normal SDK path.
- **`mode=filters`'s `branchCategory` options are query-scoped** — a narrow query silently omits categories with zero matching results. For category ids independent of any query, use `klook-categories-scraper` instead.
- This is an unofficial, reverse-engineered integration, not affiliated with or endorsed by Klook Travel Technology Limited.

### Pricing

Pay per event. Charged **$0.003 per `search-result`** (FREE tier) — one event per row pushed to the dataset. See the Actor's Pricing tab for rates across all tiers.

# Actor input Schema

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

search = paginated full-text search (default). suggest = as-you-type suggestions. init = search screen's init state. filters = live filter schema for a query.

## `query` (type: `string`):

Search text. Required for modes search/suggest/filters.

## `start` (type: `integer`):

1-indexed result offset for mode=search.

## `size` (type: `integer`):

Results per page for mode=search.

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

Stop after this many pages for mode=search.

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

Stop once this many results have been pushed (mode=search only).

## `sort` (type: `string`):

Result sort order for mode=search.

## `date` (type: `string`):

YYYY-MM-DD — a single date, not a real range.

## `mainCategory` (type: `string`):

1=Tours & experiences, 2=Attraction tickets, 30=Transport, 54=Hotels, 70=More. Also used as the tab for mode=filters.

## `branchCategory` (type: `string`):

Sub-category id — see klook-categories-scraper or mode=filters.

## `guidedLanguage` (type: `string`):

Tour guide language id, e.g. 3029=English guided.

## `services` (type: `array`):

Service filter ids (small group, hotel pick-up, free cancellation, guaranteed departure, ...).

## `departureTime` (type: `array`):

Departure-time filter ids (evening/afternoon departure, ...).

## `duration` (type: `array`):

Duration filter ids (0-3 hours, 3-5 hours, full day, 2+ days, ...).

## `reviewScore` (type: `string`):

3, 3.5, 4, or 4.5.

## `priceMin` (type: `number`):

Minimum price to filter results.

## `priceMax` (type: `number`):

Maximum price to filter results.

## `other` (type: `array`):

e.g. other\_instant\_key=Instant confirmation, 36822=Halal-friendly.

## `location` (type: `string`):

Narrow results to a location id, e.g. 1012=Japan.

## `currency` (type: `string`):

ISO currency code, default GBP.

## Actor input object example

```json
{
  "mode": "search",
  "query": "tokyo",
  "start": 1,
  "size": 10,
  "maxPages": 10,
  "currency": "GBP"
}
```

# Actor output Schema

## `dataset` (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 = {
    "query": "tokyo"
};

// Run the Actor and wait for it to finish
const run = await client.actor("romy/klook-search-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 = { "query": "tokyo" }

# Run the Actor and wait for it to finish
run = client.actor("romy/klook-search-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 '{
  "query": "tokyo"
}' |
apify call romy/klook-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,romy/klook-search-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/oWngmHMdNGsF6kJyJ/builds/6y5jzQkBKhNnRVBE0/openapi.json