Shopee Category Tree Scraper

Shopee's complete category taxonomy, flattened into a clean table — across 11 marketplaces, one HTTP request each. No API key, no login, no browser.

Every row carries its own ancestry, so you never have to walk a nested JSON blob: categoryId, parentId, path, pathIds, level, isLeaf and a working category URL.

---

What you get

{
  "categoryId": 11027727,
  "name": "Tops",
  "region": "sg",
  "country": "Singapore",
  "level": 2,
  "parentId": 11012819,
  "parentName": "Women's Apparel",
  "path": "Women's Apparel > Tops",
  "pathIds": [11012819, 11027727],
  "rootId": 11012819,
  "rootName": "Women's Apparel",
  "isLeaf": true,
  "childCount": 0,
  "url": "https://shopee.sg/Tops-cat.11012819.11027727",
  "imageUrl": "https://down-sg.img.susercontent.com/file/sg-50009109-08d5…"
}

Field	Notes
categoryId	Shopee's catid — the value product records reference
path / pathIds	Full breadcrumb as text and as IDs
level	Counted by the walk itself, so it is always right
isLeaf / childCount	Leaves are where products are actually filed
url	Built from the full ancestry, the way Shopee's own breadcrumbs do
region / country	Which marketplace this row came from

About the URL

A Shopee category is addressed by its whole ancestry, not by its own ID: /Tops-cat.11012819.11027727, not /Tops-cat.11027727. This Actor builds it correctly, and the format is pinned in the test suite against real URLs taken from Shopee's own breadcrumb JSON-LD.

For non-Latin names (Thai, Vietnamese, Chinese) the slug falls back to the category ID — https://shopee.co.th/11045208-cat.11044959.11045208. The slug is cosmetic; Shopee resolves the page from the trailing IDs.

Input

{
  "regions": ["sg", "my", "id"],
  "maxDepth": 0,
  "leavesOnly": false
}

Option	Default	Notes
regions	["sg"]	One request each.
maxDepth	0 (whole tree)	1 = departments only, 2 = departments + subcategories.
leavesOnly	false	Keep only categories with no children.
maxItems	10000	Hard cap across all marketplaces.
proxyConfiguration	off	Leave off — see below.

Filters are applied after the tree is walked, never during it — so a filtered row still carries its complete, correct parent path.

Marketplaces

Singapore · Malaysia · Indonesia · Thailand · Vietnam · Philippines · Taiwan · Brazil · Mexico · Colombia · Chile

Category names come back in each marketplace's own language, and category IDs differ per country — Singapore's tree is not Thailand's with translations. Verified live: SG has 260 categories, TH has 264.

Speed and cost

One request per marketplace. Singapore and Thailand together — 524 categories — take about 4 seconds at 256 MB. No browser is launched.

No proxy is used unless Shopee actually blocks an IP, and then the Actor escalates on its own — datacenter first (included in every Apify plan, free tier included), residential only if your plan has it.

Use it for

• Marketplace integration — map your own catalogue's categories onto Shopee's IDs before listing.
• Decoding product data — turn the categoryId on a scraped product into a readable breadcrumb.
• Cross-market comparison — see how the same department is split differently in SG, MY and ID.
• Category-level research — a complete, stable frame to structure assortment analysis around.

Related

Shopee Product Catalog & Variant Scraper returns the categoryId these rows decode, Shopee Official Brand Store Directory lists the brands, and Shopee Shop & Seller Profile Scraper covers the sellers.