HKTDC Supplier Scraper

Scrape supplier / manufacturer listings from HKTDC Sourcing (sourcing.hktdc.com) by keyword.

HKTDC's supplier search is a React single-page app — the company cards are rendered client-side after the page's bootstrap API calls resolve, so a plain HTTP request returns an empty shell. This actor drives a real Chromium browser (via Playwright), waits for the cards to render, and parses them into clean, structured records.

Input

Field	Type	Description
searchTerms	array of strings	Required. Keywords to search (e.g. "led lighting"). Each term is searched independently.
maxItemsPerTerm	integer	Max unique suppliers to collect per term. Default 50.
proxyConfiguration	object	Proxy settings. Residential HK proxy is required — see note below.
maxConcurrency	integer	How many search terms to process in parallel. Default 2.

Example input

{
    "searchTerms": ["led lighting"],
    "maxItemsPerTerm": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "HK"
    }
}

Output

One dataset item per supplier. Example records from a real "led lighting" search:

[{
  "supplier_name": "Elumen LED Lighting Solutions Company Limited",
  "platform": "HKTDC",
  "detail_url": "https://sourcing.hktdc.com/en/Supplier-Store/Home/Elumen-LED-Lighting-Solutions-Company-Limited/1X06TW48?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N",
  "location": "Hong Kong",
  "business_type": "Manufacturer",
  "main_category": "Main Category :  Environmental Protection, Lights, Parts, Electrical Electronic Supplies",
  "products": [
    {
      "name": "Nichia 3030 90Ra LED IC Flexible Strip",
      "image": "https://sourcing-media.hktdc.com/product/Nichia-3030-90Ra-LED-IC-Flexible-Strip/6ad820efa61f4c1e83d8ec96aebef3eb.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/Nichia-3030-90Ra-LED-IC-Flexible-Strip-1Z03MTXY9?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "Nichia 3030 90Ra LED Flexible Strip (IP65 Waterproof)",
      "image": "https://sourcing-media.hktdc.com/product/Nichia-3030-90Ra-LED-Flexible-Strip-IP65-Waterproof-/162c3086d7aa45ed968cf343528d4b0c.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/Nichia-3030-90Ra-LED-Flexible-Strip-IP65-Waterproof--1Z03MTH2D?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "Industrial IK10 & IP67 AC Long Run LED Flexible Strip (Single Side)",
      "image": "https://sourcing-media.hktdc.com/product/Industrial-IK10-IP67-AC-Long-Run-LED-Flexible-Strip-Single-Side-/0dcbded27dc54a03b1cdbbb0f3ad47ca.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/Industrial-IK10-IP67-AC-Long-Run-LED-Flexible-Strip-Single-Side--1Z03MZIOI?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    }
  ],
  "product_images": [
    "https://sourcing-media.hktdc.com/product/Nichia-3030-90Ra-LED-IC-Flexible-Strip/6ad820efa61f4c1e83d8ec96aebef3eb.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/Nichia-3030-90Ra-LED-Flexible-Strip-IP65-Waterproof-/162c3086d7aa45ed968cf343528d4b0c.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/Industrial-IK10-IP67-AC-Long-Run-LED-Flexible-Strip-Single-Side-/0dcbded27dc54a03b1cdbbb0f3ad47ca.webp?width=300&height=300&mode=cover"
  ],
  "search_term": "led lighting"
},
{
  "supplier_name": "Citylux (China) Led Lighting Limited",
  "platform": "HKTDC",
  "detail_url": "https://sourcing.hktdc.com/en/Supplier-Store/Home/Citylux-China-Led-Lighting-Limited/1X08711W?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N",
  "location": "Guangdong, Chinese Mainland",
  "business_type": "Manufacturer",
  "main_category": "Main Category :  Environmental Protection, Lights",
  "products": [
    {
      "name": "Custom Led Neon Sign",
      "image": "https://sourcing-media.hktdc.com/product/Custom-Led-Neon-Sign/a263388ea42544b2bdfc1c3e114703b6.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/Custom-Led-Neon-Sign-1Z03OMTSV?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "Custom Led Light Sheet Panel",
      "image": "https://sourcing-media.hktdc.com/product/Custom-Led-Light-Sheet-Panel/2b8f0b9268844e1c8c716165e2d95c90.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/Custom-Led-Light-Sheet-Panel-1Z03OMTO7?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "Desktop A4 Led Light Box",
      "image": "https://sourcing-media.hktdc.com/product/Desktop-A4-Led-Light-Box/806d5cf094a342409827b51f200d9f1e.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/Desktop-A4-Led-Light-Box-1Z03OMSO8?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    }
  ],
  "product_images": [
    "https://sourcing-media.hktdc.com/product/Custom-Led-Neon-Sign/a263388ea42544b2bdfc1c3e114703b6.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/Custom-Led-Light-Sheet-Panel/2b8f0b9268844e1c8c716165e2d95c90.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/Desktop-A4-Led-Light-Box/806d5cf094a342409827b51f200d9f1e.webp?width=300&height=300&mode=cover"
  ],
  "search_term": "led lighting"
},
{
  "supplier_name": "ZhongShan Caij Lighting Technology Co., Ltd",
  "platform": "HKTDC",
  "detail_url": "https://sourcing.hktdc.com/en/Supplier-Store/Home/ZhongShan-Caij-Lighting-Technology-Co-Ltd/1S00OKYDZ?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N",
  "location": "Guangdong, Chinese Mainland",
  "business_type": "Manufacturer, Exporter",
  "main_category": "Main Category :  Engineering & Construction Machinery, Homeware & Lifestyle Essentials, Lights",
  "products": [
    {
      "name": "RGBW-CA21D12.12-DMX512 led strip light-SMD5050-84PCS",
      "image": "https://sourcing-media.hktdc.com/product/RGBW-CA21D12-12-DMX512-led-strip-light-SMD5050-84PCS/ea0f003cf1c34225b8f2dcece78f5a99.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/RGBW-CA21D12-12-DMX512-led-strip-light-SMD5050-84PCS-1Z03OIPJQ?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "34款14洗墙灯",
      "image": "https://sourcing-media.hktdc.com/product/34%E6%AC%BE14%E6%B4%97%E5%A2%99%E7%81%AF/db319988a9414fa78e767203e4a56da9.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/34款14洗墙灯-1Z03O5KDD?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "RGBW-CA21D12.14- led strip light-SMD5050 96-PCS",
      "image": "https://sourcing-media.hktdc.com/product/RGBW-CA21D12-14-led-strip-light-SMD5050-96-PCS-/4db303715b584500875aa88912b99cc6.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/RGBW-CA21D12-14-led-strip-light-SMD5050-96-PCS--1Z03LVT4V?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    }
  ],
  "product_images": [
    "https://sourcing-media.hktdc.com/product/RGBW-CA21D12-12-DMX512-led-strip-light-SMD5050-84PCS/ea0f003cf1c34225b8f2dcece78f5a99.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/34%E6%AC%BE14%E6%B4%97%E5%A2%99%E7%81%AF/db319988a9414fa78e767203e4a56da9.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/RGBW-CA21D12-14-led-strip-light-SMD5050-96-PCS-/4db303715b584500875aa88912b99cc6.webp?width=300&height=300&mode=cover"
  ],
  "search_term": "led lighting"
},
{
  "supplier_name": "Better LED Lighting Co.,LTD",
  "platform": "HKTDC",
  "detail_url": "https://sourcing.hktdc.com/en/Supplier-Store/Home/Better-LED-Lighting-Co-LTD/1X05WRYT?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N",
  "location": "Hong Kong",
  "business_type": "Manufacturer",
  "main_category": "Main Category :  Environmental Protection, Festive Supplies, Gifts, Toys & Sports Supplies, Lights",
  "products": [
    {
      "name": "E27 String Light",
      "image": "https://sourcing-media.hktdc.com/product/E27-String-Light/b6b634a1e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/E27-String-Light-1X242YOI?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "LED Holiday String Light",
      "image": "https://sourcing-media.hktdc.com/product/LED-Holiday-String-Light/b6b63440e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/LED-Holiday-String-Light-1X242YNJ?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "LED String Light IP65",
      "image": "https://sourcing-media.hktdc.com/product/LED-String-Light-IP65/b6b633e8e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/LED-String-Light-IP65-1X242YMK?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    }
  ],
  "product_images": [
    "https://sourcing-media.hktdc.com/product/E27-String-Light/b6b634a1e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/LED-Holiday-String-Light/b6b63440e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/LED-String-Light-IP65/b6b633e8e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover"
  ],
  "search_term": "led lighting"
},
{
  "supplier_name": "Asia Unique LED Lighting Co Ltd",
  "platform": "HKTDC",
  "detail_url": "https://sourcing.hktdc.com/en/Supplier-Store/Home/Asia-Unique-LED-Lighting-Co-Ltd/1X074V1E?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N",
  "location": "Guangdong, Chinese Mainland",
  "business_type": "Manufacturer",
  "main_category": "Main Category :  Environmental Protection, Lights",
  "products": [
    {
      "name": "LED UFO highbay light",
      "image": "https://sourcing-media.hktdc.com/product/LED-UFO-highbay-light/b6c73dd1e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/LED-UFO-highbay-light-1X249TWP?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "IP69K Tri-Proof Light",
      "image": "https://sourcing-media.hktdc.com/product/IP69K-Tri-Proof-Light/b6c73d6de39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/IP69K-Tri-Proof-Light-1X249TVQ?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    },
    {
      "name": "LED Downlight",
      "image": "https://sourcing-media.hktdc.com/product/LED-Downlight/a4b191a4e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
      "url": "https://sourcing.hktdc.com/en/Product-Detail/LED-Downlight-1X1JT8WG?ref_source=SearchKeyword&ref_term=led%20lighting&ref_medium=N"
    }
  ],
  "product_images": [
    "https://sourcing-media.hktdc.com/product/LED-UFO-highbay-light/b6c73dd1e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/IP69K-Tri-Proof-Light/b6c73d6de39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover",
    "https://sourcing-media.hktdc.com/product/LED-Downlight/a4b191a4e39d11ea883f06c82c63b760.webp?width=300&height=300&mode=cover"
  ],
  "search_term": "led lighting"
}]

website is only present when the supplier card exposes an external (non-HKTDC) link — not all suppliers list one.

Proxy requirement

A residential proxy in Hong Kong is required. HKTDC blocks datacenter and cloud IPs (AWS, GCP, Azure, and Apify's shared datacenter pool) with a bare 403 Forbidden before the page even loads. Without a residential HK proxy every page returns 403 and the actor produces no results.

Use the default proxyConfiguration in the input (Apify Residential proxy, country HK). Residential proxy is a paid Apify feature — it is not available on the free plan. To enable it, go to console.apify.com → Proxy and activate Residential access.

Running without a proxy (or with a datacenter proxy) will not raise an error — the actor will log 403 Forbidden for each page and finish with 0 results.

Running locally

# With the Apify CLI:
apify run

# Or plain Python (install deps + chromium first):
pip install -r requirements.txt
playwright install chromium
python actor_main.py

Notes

• The scraper walks result pages until maxItemsPerTerm is reached or two consecutive pages return nothing new (HKTDC re-serves the last page once results run out, so the actor stops instead of looping forever).
• HKTDC geo-localizes results; a Hong Kong exit node returns more relevant Hong Kong and mainland China suppliers than a US or EU proxy would.