TikTok Shop Categories Scraper avatar

TikTok Shop Categories Scraper

Pricing

from $3.23 / 1,000 results

Go to Apify Store
TikTok Shop Categories Scraper

TikTok Shop Categories Scraper

Export TikTok Shop's full category tree for any region as one flat table. Every row carries the category ID, name, URL slug, tree depth, and parent, ready to rebuild the tree or map your catalog. Export scraped data, run via API, and keep your TikTok Shop mapping current.

Pricing

from $3.23 / 1,000 results

Rating

0.0

(0)

Developer

ToolzerHub

ToolzerHub

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

7 hours ago

Last modified

Share

Export TikTok Shop's whole category tree for a region as a flat table — one row per category, parent included.

What you get

FieldHolds
category_idThe category's ID
category_nameDisplay name shoppers see
category_name_enThe slug TikTok uses in category URLs — not the display name
category_levelDepth in the tree. 1 is top level
parent_category_idThe parent category's ID. Empty at the top level
parent_category_nameThe parent category's display name. Empty at the top level
categoryThe complete category record, for anything not broken out above
{
"category_id": "848776",
"category_name": "Skincare",
"category_name_en": "skincare",
"category_level": 2,
"parent_category_id": "601450",
"parent_category_name": "Beauty & Personal Care",
"category": {
"category_id": "848776",
"category_name": "Skincare",
"category_name_en": "skincare"
}
}

Flattening it is the point — a tree is awkward to search or join against; a table with a parent_category_id on every row lets you rebuild the hierarchy or map it onto your own catalog with a plain lookup.

Input

FieldTypeDefaultWhat it does
regionenumUSRequired. US, GB, SG, MY, PH, TH, VN, ID.
maxItemsinteger100How many category rows to save. 0 saves the whole tree.
{
"region": "US",
"maxItems": 100
}

The whole tree comes back in one response — maxItems only trims how many flattened rows get saved, it doesn't change how deep or wide the tree is walked.

Questions

Why are parent_category_id and parent_category_name blank on some rows? Those are the top-level categories — category_level: 1. A top-level category has no parent, so both fields come back empty rather than pointing at something that doesn't exist.

Can a category have children but no name of its own? Yes, and it still shows up correctly. TikTok occasionally returns a branch where a node has children but no category record of its own. Rather than dropping that branch — which would orphan every category under it — the children are still walked and yielded with whatever parent link is available.

What's the difference between category_name and category_name_en? category_name is what a shopper reads. category_name_en is the slug TikTok bakes into category URLs — useful if you're matching categories against links rather than display text.

Does the region change the category tree, not just the language? region is sent with the request and the tree comes back per market, so treat each region as its own export rather than a translation of the US one. If a category you expect isn't there, request the region you actually sell in before assuming it doesn't exist.

Other TikTok Shop Actors

ActorUse when
TikTok Shop Category Products ScraperYou've got a category_id and want the products in it
TikTok Shop Trending Products ScraperYou want what's selling, not the taxonomy behind it
TikTok Shop Keyword Ideas ScraperYou'd rather start from a search term than a category

Support

Questions, bugs, or feature requests: contact@toolzerhub.com

Browse the rest: apify.com/toolzerhub