Catalog/TikTok Shop/Categories
POST

TikTok Shop Categories API

/v1/run/tiktok_shop.categories

List the TikTok Shop category tree for a market: top-level categories with ids, slugs, and images, each with its child categories.

Category shopRequests / mo -Routing 1 lane · no failover
Get ~100 free requests

Pricing

One price, in dollars

pay per request · no subscription · fallbacks added as the catalog grows
Request
Gateway request
discovered operation
↓
Router
↓
Providers · 1
↳ One lane serves this endpoint today, so a failed call has nowhere to fail over to. Failed attempts are never billed. Uptime, latency and traffic are measured through the gateway, last 30 days.

Try it

Make your first request

run it free, no key · same shape for every API
Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "data": {
    "categories": [
      {
        "categoryId": "general",
        "children": [
          {
            "categoryId": "general",
            "isLeaf": true,
            "name": "Example title",
            "slug": "alex_rivera"
          }
        ],
        "image": "https://example.com/image.jpg",
        "isLeaf": true,
        "name": "Example title",
        "slug": "alex_rivera"
      }
    ]
  },
  "found": true
}
Response interface
interface TiktokShopCategoriesResponse {
  data: {
    categories: {
      categoryId: string;
      children?: {
        categoryId: string;
        isLeaf?: boolean;
        name: string;
        slug?: string;
      }[];
      image?: string;
      isLeaf?: boolean;
      name: string;
      slug?: string;
    }[];
  } | null;
  found: boolean;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-08-23 · uptime and latency measured over 30d
POST /v1/run/tiktok_shop.categories
curl -X POST https://api.getanyapi.com/v1/run/tiktok_shop.categories \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"US"}'
FieldTypeExample value
Request body
regionenum"US"Country code of the TikTok Shop market whose category tree to list. Only US and VN publish a category tree.
Response
dataobject
data.categoriesobject[]Top-level TikTok Shop categories for the market, each with its child categories. Populated whenever the provider has data for the entity.
data.categories[].categoryIdstringTikTok Shop category id. Pass this to tiktok_shop.category_products. Populated whenever the provider has data for the entity.
data.categories[].childrenobject[]Child categories one level down.
data.categories[].children[].categoryIdstringTikTok Shop category id.
data.categories[].children[].isLeafbooleanTrue when the category has no children.
data.categories[].children[].namestringDisplay name of the category.
data.categories[].children[].slugstringURL slug of the category.
data.categories[].imagestringCategory tile image URL.
data.categories[].isLeafbooleanTrue when the category has no children.
data.categories[].namestringDisplay name of the category. Populated whenever the provider has data for the entity.
data.categories[].slugstringURL slug of the category.
foundboolean
Price
Price per requestUSD$0.0012
Price /1k reqUSD$1.20

FAQ

About the TikTok Shop Categories API

The AnyAPI TikTok Shop Categories API returns TikTok Shop categories data as normalized JSON from one POST call to /v1/run/tiktok_shop.categories. List the TikTok Shop category tree for a market: top-level categories with ids, slugs, and images, each with its child categories. AnyAPI returns one normalized schema whichever source serves it. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum.

It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

List the TikTok Shop category tree for a market: top-level categories with ids, slugs, and images, each with its child categories. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Get started

Two ways to start on AnyAPI

Humans fund a USD wallet and pay per request. Agents point a coding agent at one URL and onboard themselves.

Get ~100 free requests
Works with
Terminal agentsClaude CodeCursorCodexMCP clients