# OpenRice Scraper – Hong Kong Restaurants, Ratings & Reviews (`claude_code_reviewer/openrice-scraper-en`) Actor Scrape OpenRice (Hong Kong's largest restaurant guide) without an API: name, district, cuisine, rating, review count, price range, address and phone. Bulk-paste keywords; export JSON/CSV/Excel. Great for site selection and F\&B market research. - **URL**: https://apify.com/claude\_code\_reviewer/openrice-scraper-en.md - **Developed by:** [Chad](https://apify.com/claude_code_reviewer) (community) - **Categories:** Agents, Social media, Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 restaurant results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## OpenRice Scraper | Hong Kong Restaurant Data, Ratings, Districts & Cuisines (No API) Scrape restaurant search listings from [OpenRice](https://www.openrice.com/en/hongkong) Hong Kong, including restaurant name, cuisine, district, rating, review count, address, phone number, image URLs and more. - **Public JSON API** — no login, no token, no browser required - **The only stable option**: the sole competitor on Apify Store has been stuck under `UNDER_MAINTENANCE` for a long time, with 30/38 runs timing out - **Bulk keyword search**: run multiple keywords in one job, with optional district / cuisine ID filters - **Structured output**: snake_case fields, missing values filled with `null`, every row stamped with an ISO 8601 timestamp --- ### Output fields | Field | Type | Description | Version | |---|---|---|---| | `poi_id` | string | OpenRice restaurant unique ID | v1.0 | | `name` | string \| null | Restaurant name (Chinese) | v1.0 | | `cuisine` | string[] \| null | Cuisine array (e.g. `["Japanese", "Sushi/Sashimi"]`) | v1.0 | | `district` | string \| null | District name (e.g. "Causeway Bay") | v1.0 | | `price_range` | string \| null | Price range: `$` / `$$` / `$$$` / `$$$$` | v1.0 | | `rating` | number \| null | OpenRice overall rating (e.g. `3.87`) | v1.0 | | `review_count` | integer \| null | Number of reviews | v1.0 | | `bookmark_count` | integer \| null | Number of users who bookmarked the restaurant | v1.0 | | `address` | string \| null | Restaurant address (Chinese) | v1.0 | | `phone` | string \| null | Phone number (first one) | v1.0 | | `opening_hours` | string \| null | Opening hours as a JSON string (v1.1 will switch to a human-readable format) | v1.0 | | `image_urls` | string[] | Array of restaurant image URLs (`[]` if none) | v1.0 | | `restaurant_url` | string | Full URL of the OpenRice restaurant page | v1.0 | | `source_mode` | string | Data source mode (currently `"search"`) | v1.0 | | `source_query` | string | The search keyword that produced this row | v1.0 | | `scraped_at` | string | Scrape timestamp (ISO 8601, UTC) | v1.0 | --- ### Modes | mode | Input | Output | Billing event | |---|---|---|---| | `search` (v1.0) | `keywords[]` + optional `district` / `cuisine` filters | Search listing results | `search-listing` ($0.002 per row) | | `detail` (v1.1, in development) | `restaurantIds[]` or `restaurantUrls[]` | Full restaurant detail | `product-detail` | --- ### Input parameters | Parameter | Type | Required | Default | Description | |---|---|---|---|---| | `keywords` | string[] | ✓ | — | Search keywords (restaurant name / cuisine), up to 50 | | `bulkInput` | string | — | — | One keyword per line, automatically merged into `keywords` | | `district` | string | — | — | District ID (e.g. `1019` = Causeway Bay, see below) | | `cuisine` | string | — | — | Cuisine ID (e.g. `2009` = Japanese, see below) | | `maxItems` | integer | — | `50` | Max results per keyword (1-500) | | `proxyConfiguration` | object | — | disabled | Apify Proxy or a custom proxy | #### Common district IDs | districtId | District | |---|---| | 1999 | Hong Kong Island (all) | | 1019 | Causeway Bay | | 1001 | Sheung Wan / Central | | 2999 | Kowloon (all) | | 2010 | Mong Kok | | 2001 | Tsim Sha Tsui | | 3999 | New Territories (all) | For the full list, call `GET https://www.openrice.com/api/v2/metadata/region/all?uiLang=zh&uiCity=hongkong`. #### Common cuisine IDs | cuisineId | Cuisine | |---|---| | 1004 | Cantonese / HK-style | | 2009 | Japanese | | 4000 | Western | | 1007 | Chinese | | 2001 | Korean | --- ### Input examples #### 1. Search for sushi (default settings) ```json { "keywords": ["sushi"], "maxItems": 20 } ```` #### 2. BBQ filtered to Central/Sheung Wan (districtId=1001) ```json { "keywords": ["bbq"], "district": "1001", "maxItems": 20 } ``` #### 3. Multiple keywords in one run ```json { "keywords": ["japanese food", "korean bbq"], "maxItems": 50 } ``` #### 4. Japanese restaurants in Mong Kok (district + cuisine filter combined) ```json { "keywords": ["sushi"], "district": "2010", "cuisine": "2009", "maxItems": 30 } ``` #### 5. Bulk-paste multiple keywords ```json { "bulkInput": "sushi\nbbq\nhot pot\ncha chaan teng\ndim sum", "maxItems": 30 } ``` *** ### Notes - **Reliability is the selling point**: the only competitor has been stuck `UNDER_MAINTENANCE` for a long time (30/38 runs timing out); this Actor uses a pure JSON API, no browser, and exponential-backoff retries — finishing the job is the whole point - **Billing timing**: `Actor.charge()` is only called after data has been successfully pushed to the dataset; failures mid-run are never billed - **Consecutive empty-page detection**: the run auto-stops if 5 consecutive pages return no new data, avoiding wasted compute - **`detail` mode (v1.1)**: OpenRice's POI detail API endpoint is not currently public — all probe requests return 404; will be added once found or reverse-engineered *** ### FAQ **Q: Why are some fields `null`?** A: Some OpenRice restaurant listings have incomplete data (e.g. no phone number, no address filled in). This Actor always fills missing values with `null` instead of dropping the field, so every row keeps a consistent structure. **Q: What format is `opening_hours` in?** A: In v1.0 it's a JSON string containing per-day fields like `dayOfWeek` (1=Sunday, 2=Monday...7=Saturday), `period1Start`, `period1End`, `is24hr`, `isClose`, etc. v1.1 will switch to a human-readable format. **Q: Can I search a specific district only?** A: Yes — fill in `district` with a districtId (e.g. `1019` = Causeway Bay). The full districtId list is available from the metadata API. **Q: Is proxy supported?** A: Yes, both Apify Proxy and a custom proxy are supported; disabled by default since direct connections already scrape reliably. **Q: Does `image_urls` include all photos?** A: It includes the restaurant's main photo (doorPhoto) plus the latest images returned in the search listing (usually 3-5). The full photo album requires detail mode (v1.1). **Q: Can I scrape review content?** A: A reviews mode is planned for v1.1 and is not yet implemented. *** ### Deploy ```bash npm install npm run build apify push ``` Local testing: ```bash apify run --input='{"keywords":["sushi"],"maxItems":5}' ``` *** ### Disclaimer This tool is intended only for lawful research and analysis of publicly accessible data. Users must comply with [OpenRice's Terms of Service](https://www.openrice.com/en/hongkong/legal/terms), avoid mass scraping, avoid use for commercial competition, and avoid storing personal data. The author bears no responsibility for how users choose to use this tool. *** *OpenRice scraper, Hong Kong restaurants, HK dining data, restaurant ratings, cuisine search, OpenRice API, Hong Kong food data* # Actor input Schema ## `keywords` (type: `array`): Restaurant names or cuisine keywords to search for. Each search result is billed at $0.002. ## `bulkInput` (type: `string`): One keyword per line, automatically merged into keywords. ## `district` (type: `string`): Filter by districtId (obtained from the metadata API). For example: 1019 = Causeway Bay, 2010 = Mong Kok, 1001 = Sheung Wan. Leave blank for no district filter. ## `cuisine` (type: `string`): Filter by cuisineId (obtained from the metadata API). For example: 2009 = Japanese, 1004 = Cantonese/HK-style. Leave blank for no cuisine filter. ## `maxItems` (type: `integer`): Maximum number of results per keyword (1-500, default 50). ## `proxyConfiguration` (type: `object`): Optionally use Apify Proxy or a custom proxy. Proxy is disabled (direct connection) by default. ## Actor input object example ```json { "keywords": [ "sushi", "bbq", "japanese food" ], "bulkInput": "sushi\nbbq\ncantonese", "district": "1019", "cuisine": "2009", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "sushi" ] }; // Run the Actor and wait for it to finish const run = await client.actor("claude_code_reviewer/openrice-scraper-en").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 = { "keywords": ["sushi"] } # Run the Actor and wait for it to finish run = client.actor("claude_code_reviewer/openrice-scraper-en").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 '{ "keywords": [ "sushi" ] }' | apify call claude_code_reviewer/openrice-scraper-en --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=claude_code_reviewer/openrice-scraper-en", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OpenRice Scraper – Hong Kong Restaurants, Ratings & Reviews", "description": "Scrape OpenRice (Hong Kong's largest restaurant guide) without an API: name, district, cuisine, rating, review count, price range, address and phone. Bulk-paste keywords; export JSON/CSV/Excel. Great for site selection and F&B market research.", "version": "1.0", "x-build-id": "OmZPZkn3eNnr3dDIU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/claude_code_reviewer~openrice-scraper-en/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-claude_code_reviewer-openrice-scraper-en", "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/claude_code_reviewer~openrice-scraper-en/runs": { "post": { "operationId": "runs-sync-claude_code_reviewer-openrice-scraper-en", "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/claude_code_reviewer~openrice-scraper-en/run-sync": { "post": { "operationId": "run-sync-claude_code_reviewer-openrice-scraper-en", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Restaurant names or cuisine keywords to search for. Each search result is billed at $0.002.", "items": { "type": "string" } }, "bulkInput": { "title": "Bulk Input", "type": "string", "description": "One keyword per line, automatically merged into keywords." }, "district": { "title": "District ID", "type": "string", "description": "Filter by districtId (obtained from the metadata API). For example: 1019 = Causeway Bay, 2010 = Mong Kok, 1001 = Sheung Wan. Leave blank for no district filter." }, "cuisine": { "title": "Cuisine ID", "type": "string", "description": "Filter by cuisineId (obtained from the metadata API). For example: 2009 = Japanese, 1004 = Cantonese/HK-style. Leave blank for no cuisine filter." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of results per keyword (1-500, default 50).", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optionally use Apify Proxy or a custom proxy. Proxy is disabled (direct connection) by default.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```