# HKTVmall Scraper (`aboo.script/hktvmall-scraper`) Actor

Scrape HKTVmall products from category, search and product URLs or keywords: prices, discounts, stock, ratings, store, specifications and images.

- **URL**: https://apify.com/aboo.script/hktvmall-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 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/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

## HKTVmall Scraper

![HKTVmall Scraper](https://i.ibb.co/GQBZwk0g/hktvmall-banner.png)

**HKTVmall Scraper** extracts product data from [HKTVmall](https://www.hktvmall.com/), Hong Kong's largest online shopping platform, into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste an HKTVmall category, search, or product URL, or type a few keywords, and get the price, discount, stock, rating, store, specifications, and images of every product. No account or login required.

### Introduction

[HKTVmall](https://www.hktvmall.com/) is the biggest e-commerce marketplace in Hong Kong, with thousands of stores selling groceries, pet supplies, electronics, beauty, health, and home products to millions of shoppers. Its product pages show live prices, promotions, stock levels, and customer ratings, which makes it a key source of Hong Kong retail data.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from HKTVmall?

- 🏷️ Product name, SKU, brand, summary, and full description
- 💲 Current price, original (crossed-out) price, amount saved, and currency
- 📦 Stock status, stock level, and whether the product can be bought
- ⭐ Average rating, number of reviews, and sample customer reviews
- 🏪 Store name, store code, store rating, and store link
- 🗂️ Main category, category code, and the full category path
- 🎁 Promotions and promotion text, flash sale flag
- 🚚 Delivery mode, delivery time, delivery remarks, and return days
- 🌍 Country of origin, shelf life, and other specifications
- 🧩 Product variants (size, color, and other options) with their stock
- 🖼️ High-resolution images and product videos
- 🔗 Direct URL to each product page

### Use Cases

- 📈 **Market research**: track prices, discounts, and best sellers across HKTVmall categories.
- 🕵️ **Competitor monitoring**: follow what competing stores sell, at what price, and with which promotions.
- 🏷️ **Price tracking**: schedule daily runs to spot price drops and new deals in Hong Kong.
- 🗂️ **Database building**: create your own catalog of Hong Kong retail products with specifications and images.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape HKTVmall step by step

1. Paste one or more HKTVmall URLs into **Start URLs**, or type keywords into **Search queries**.
2. Set **Maximum number of results** to how many products you want per URL or per query.
3. Click **Start** and wait for the run to finish.
4. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: HKTVmall URLs to scrape, from the English or Chinese site. Supported pages: category pages, search result pages, and single product pages. Any sorting or filters you apply on a category page (such as price order or brand) are kept in the results.
- **Search queries**: keywords to search on HKTVmall, one per line. Each query is scraped separately.
- **Maximum number of results**: how many products to collect for each start URL or search query. Use 0 for no limit.
- **Proxy configuration**: HKTVmall only works reliably with Hong Kong residential proxies, which are selected by default. Keep this setting for stable results.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape a category page from HKTVmall:

```json
{
  "startUrls": [
    {
      "url": "https://www.hktvmall.com/hktv/en/main/search?q=%3Arelevance%3Astreet%3Amain%3Acategory%3AAA83100500000"
    }
  ],
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "HK"
  }
}
```

Search by keywords:

```json
{
  "searchQueries": ["dog food"],
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "HK"
  }
}
```

### Output

Each product is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://www.hktvmall.com/hktv/en/main/Castle-Pet-Shop/s/H8221001/Pets/Pets/For-Dog/Dog-Food/Dry-Dog-Food/Sensitive-Formulated-Dog-Food/Free-Run-Duck-Dry-Dog-Food-10kg-ExpDate-Sep2027/p/H8221001_S_AATU_DDUCK10KG",
  "sku": "H8221001_S_AATU_DDUCK10KG",
  "name": "Free Run Duck Dry Dog Food 10kg Exp.Date Sep/2027",
  "brand": "AATU",
  "price": 982,
  "originalPrice": 1157,
  "savedAmount": 175,
  "currency": "HKD",
  "inStock": true,
  "stockStatus": "In Stock",
  "stockLevel": 9,
  "purchasable": true,
  "rating": 5,
  "reviewCount": 3,
  "salesVolume": "600+ Sold",
  "storeCode": "H8221001",
  "storeName": "Castle Pet Shop",
  "storeRating": 4,
  "storeUrl": "https://www.hktvmall.com/hktv/en/s/H8221001",
  "primaryCategory": "Sensitive Formulated Dog Food",
  "primaryCategoryCode": "AA83100510501",
  "categoryPath": ["Pets", "For Dog", "Dog Food", "Dry Dog Food", "Sensitive Formulated Dog Food"],
  "zone": "pets",
  "countryOfOrigin": "EU",
  "shelfLife": "01/09/2027 (DD/MM/YYYY) or after",
  "specifications": [
    { "name": "Country of Origin", "value": "EU" },
    { "name": "Expiry date", "value": "01/09/2027 (DD/MM/YYYY) or after" }
  ],
  "summary": "AATU is handcrafted in small batch recipes, naturally made without artificial colours, without artificial preservatives,...",
  "description": "Composition :\n80% Duck (51% Duck, 29% Dehydrated Duck), Sweet Potato, Chickpeas, Peas, Lucerne, Salmon Oil, Duck Stock, Carrots, Tomato, Chicory, Tapioca, Apple...",
  "promotionText": "Exp.Date Sep/2027",
  "promotions": ["Free Pramy Dog Wet Pouch x1", "Dog Feeding Offer 2"],
  "isFlashSale": false,
  "deliveryMode": "HKTV Standard Delivery",
  "deliveryPeriod": "24h Delivery/ 8h Self Pick Up",
  "deliveryRemark": "Receive tomorrow if the order placed before 10PM",
  "returnDays": 0,
  "images": [
    "https://cdn-media.hktvmall.com/hktv-mms/HKTV/mms/uploadProductImage/a578/0472/afe8/SccSXvXQbS20260302161447_1200.jpg",
    "https://cdn-media.hktvmall.com/hktv-mms/HKTV/mms/uploadProductImage/4147/ba30/9179/hvATLSdabH20250819160046_1200.jpg"
  ],
  "videos": ["https://www.youtube.com/watch?v=0YSkO77rD9U"],
  "variants": [],
  "reviews": [{ "author": "GLORIA CHEUNG", "rating": 5, "text": "質素好" }],
  "scrapedAt": "2026-10-26T04:09:29.402Z"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Hong Kong residential proxies are required. Without them HKTVmall does not load and the run fails.
- Store pages (`/s/<store code>`) are not supported yet and are skipped; use a category or search URL instead.
- Sorting is only available through start URLs: sort a category page on HKTVmall and paste its URL. Search queries use HKTVmall's default "Overall score" order.
- Product names and texts are returned as the store wrote them, often in Chinese even on the English site.
- Category pages can start with sponsored products, exactly as HKTVmall shows them.
- `reviews` contains the sample of recent reviews shown on the product page, not every review; `reviewCount` is the full total.
- `variants` is empty for products sold in a single version, and `rating` is `null` for products nobody has rated yet.
- Each listing page takes a little longer than a plain web page to load, so large runs need more time.

### Why use the HKTVmall Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🎯 **Keeps your filters**: paste any sorted or filtered category URL from your browser and get exactly what you see there.
- 🧹 **Clean data**: prices and ratings are real numbers, dates use one standard format, and text is free of HTML.
- 🌐 **English and Chinese**: works with both language versions of HKTVmall.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or HKTVmall runs out of products for that URL or query.

#### Do I need an HKTVmall account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh prices and stock automatically.

#### Why are some fields empty?

Some products simply do not show every piece of information, such as a brand, shelf life, or promotion. When a field is not available on HKTVmall, it is returned as `null` or an empty list.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs and search queries. If you need other inputs, such as store pages or a sort option for keywords, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [HKTVmall](https://www.hktvmall.com/)

# Actor input Schema

## `startUrls` (type: `array`):

HKTVmall category, search or product URLs (English or Chinese site). Filters and sorting in the URL are kept.

## `searchQueries` (type: `array`):

Keywords to search on HKTVmall. Each query is scraped separately.

## `maxResults` (type: `integer`):

Maximum number of products to scrape per start URL or search query. Use 0 for no limit.

## `proxyConfiguration` (type: `object`):

HKTVmall only serves Hong Kong residential connections reliably, so residential proxies in Hong Kong are recommended.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.hktvmall.com/hktv/en/main/search?q=%3Arelevance%3Astreet%3Amain%3Acategory%3AAA83100500000"
    }
  ],
  "searchQueries": [
    "dog food"
  ],
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "HK"
  }
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.hktvmall.com/hktv/en/main/search?q=%3Arelevance%3Astreet%3Amain%3Acategory%3AAA83100500000"
        }
    ],
    "searchQueries": [
        "dog food"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/hktvmall-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 = {
    "startUrls": [{ "url": "https://www.hktvmall.com/hktv/en/main/search?q=%3Arelevance%3Astreet%3Amain%3Acategory%3AAA83100500000" }],
    "searchQueries": ["dog food"],
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/hktvmall-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 '{
  "startUrls": [
    {
      "url": "https://www.hktvmall.com/hktv/en/main/search?q=%3Arelevance%3Astreet%3Amain%3Acategory%3AAA83100500000"
    }
  ],
  "searchQueries": [
    "dog food"
  ]
}' |
apify call aboo.script/hktvmall-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/hktvmall-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/LeMLepe8xxCEUdZOV/builds/JXFDB6jnH1Mcsfb3m/openapi.json
