Managed gateway · LeanPool

Seller categories

Categories inside a seller's storefront.

GETapi.tikultra.com/v1/shop/seller/categoriesPremium · 25 credits

Upstream/api/shop/v1/category/listEvery plan

Parameters

Name	Type	Description
`seller_id`required	string	The TikTok Shop seller ID. e.g. 7495000000000000001
`region`	string	Two-letter country code for egress and storefront. e.g. US

Pricing

Plan	Per call	Per 1,000 calls
Starter	25 credits	$2.90
Growth	25 credits	$1.98
Scale	25 credits	$1.45

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -G https://api.tikultra.com/v1/shop/seller/categories \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "seller_id=7495000000000000001"

{
  "seller_id": "7495000000000000001",
  "categories": [
    {
      "category_id": "cat_keyboards",
      "name": "Keyboards",
      "product_count": 12
    },
    {
      "category_id": "cat_switches",
      "name": "Switches & Stabilizers",
      "product_count": 9
    },
    {
      "category_id": "cat_keycaps",
      "name": "Keycap Sets",
      "product_count": 7
    }
  ]
}

Try it in the playground Full reference in the docs

More in TikTok Shop

GET/v1/shop/pdpProduct page25 cr GET/v1/shop/live-bagLIVE shopping bag25 cr GET/v1/shop/searchShop search25 cr GET/v1/shop/sellerSeller catalog25 cr GET/v1/shop/seller/reviewsSeller reviews25 cr GET/v1/shop/showcaseCreator showcase25 cr GET/v1/shop/reviewsProduct reviews25 cr GET/v1/shop/anchorsShop anchors25 cr GET/v1/shop/mallMall home25 cr GET/v1/shop/tabShop tab25 cr GET/v1/shop/live-productsLIVE product pop-up25 cr GET/v1/shop/live-roomLIVE shop info25 cr GET/v1/shop/suggestionsShop suggestions25 cr GET/v1/shop/creatorShop creator25 cr GET/v1/shop/same-shopMore from this shop25 cr GET/v1/shop/recommendationsProduct recommendations25 cr GET/v1/shop/promotionsPromotions25 cr GET/v1/shop/translationProduct translation25 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing