HKTVmall
Product search and autocomplete suggestions for HKTVmall, Hong Kong's largest online shopping platform, served as plain REST. Each search hit already carries 140+ fields: price, stock status, rating, review count, images, bilingual (EN/ZH/ZH-CN) names and descriptions, full category hierarchy, store info, and promotions.
Endpoints
| Endpoint | Path params | Query params | What it returns | Price | Data up to |
|---|---|---|---|---|---|
GET /hktvmall/search |
— | keyword, page_number, page_size |
Full-text product search results. | $0.003 | 5 min |
GET /hktvmall/suggest |
— | keyword, page_size |
Autocomplete keyword suggestions with popularity scores. | $0.001 | 1 hr |
Prices are per call, paid in USDC with x402. "Data up to" is the cache window: a repeated call inside it returns the same data.
Calling it
# x402: no account or API key. The server answers 402 with payment instructions; an x402 client pays and repeats the request.
curl -i "https://<base-url>/hktvmall/search?keyword=milk"
Responses are JSON. Field names follow the upstream source, so a response can be larger than the table above suggests.
Notes
- Responses are HKTVmall's own JSON, passed through unchanged.
- Search is pure full-text keyword matching; there is no identifier-based (exact SKU/product code) lookup.
page_numberandpage_sizeare optional; unset values fall back to HKTVmall's own defaults.
