> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Shop Category Products
> A TikTok Shop category's subcategories and the top products the storefront shows for it, in the market's currency.
`children` are the direct subcategories (empty on a leaf), `products` the top products the storefront renders for the category (10–25). Works in `US`, `GB` and `ID`.
**Markets** — `region=US` (default) serves everything; `GB` and `ID` (Tokopedia) serve categories, category products and product detail in GBP/IDR. SG, MY, PH, TH, VN, MX, BR and JP sit behind a puzzle our exits do not clear and return `400`.
Each request costs **5 credits**. Failed requests are not charged.
## OpenAPI
````yaml GET /v1/tiktok/shop/categories/{category_id}
openapi: 3.1.0
info:
title: ScrapeBadger TikTok API
version: 1.0.0
description: >-
TikTok scraping API for user profiles, videos, comments, transcripts,
hashtags, music/sounds, search, trending, and the EU Commercial Content (ad
transparency) library. Returns clean structured JSON; handles signing,
anti-bot bypass, and regional proxy routing automatically.
servers:
- url: https://scrapebadger.com
description: Production
security:
- apiKeyAuth: []
paths:
/v1/tiktok/shop/categories/{category_id}:
get:
tags:
- TikTok Shop
summary: Shop Category Products
description: >-
A category's subcategories and the top products the storefront shows for
it (10-25), in the market's currency.
operationId: getTikTokShopCategory
parameters:
- name: category_id
in: path
required: true
schema:
type: string
description: Category id from a previous response (e.g. 700645 = Health).
- name: region
in: query
schema:
type: string
default: US
enum:
- US
- GB
- ID
description: >-
Market. US serves everything; GB and ID serve categories, category
products and product detail (their JSON API paths do not exist).
Other storefronts return 400.
responses:
'200':
description: Shop Category Products
content:
application/json:
schema:
$ref: '#/components/schemas/ShopCategoryResponse'
example:
category:
id: '601450'
name: Beauty & Personal Care
slug: beauty-personal-care
level: 1
is_leaf: false
parent_id: '0'
image: >-
https://lf16-tiktok-common.tiktokcdn-us.com/obj/tiktok-web-common-tx/i18n_ecom_fe/tiktok_shop_web_mono/apps/homepage_desktop/static/image/beauty-personal.fdbc446c.png
url: https://shop.tiktok.com/gb/c/beauty-personal-care/601450
children:
- id: '849032'
name: Hand & Foot Care
slug: hand-foot-care
level: 2
is_leaf: false
parent_id: '601450'
image: >-
https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/dc05090b19cd43eeac83330f8eb57ac5~tplv-omjb5zjo8w-resize-jpeg:200:200.image?
url: https://shop.tiktok.com/gb/c/hand-foot-care/849032
- id: '849544'
name: Eye & Ear Care
slug: eye-ear-care
level: 2
is_leaf: false
parent_id: '601450'
image: >-
https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/a3881f0385c94a6abeeaf472a5ef0235~tplv-o3syd03w52-resize-jpeg:200:200.image?
url: https://shop.tiktok.com/gb/c/eye-ear-care/849544
products:
- product_id: '1729731676182387423'
title: >-
Long Lasting Lip Plumper Oil, 2 Counts/set Moisturizing
Lip Plumper, Glossy Lip Glaze Stick Lipgloss, Plumping Lip
Oil Lip Stick for Girls & Women
url: https://shop.tiktok.com/gb/pdp/1729731676182387423
image: >-
https://p19-oec-eu-common-no.tiktokcdn-eu.com/tos-no1a-i-t5fjg24jzw-no...
price:
amount: 2.16
original: 2.29
discount: 6%
currency: GBP
symbol: £
rating: 3.5
review_count: 20
sold_count: 299
seller:
id: '7495629239347088095'
name: Swift Deals Makeup
logo: https://p16-oec-general.tiktokcdn-eu.com/tos-alisg...
brand: null
labels: []
video: null
rank: null
- product_id: '1729769062214441291'
title: >-
Q7Paris Mother's Day THE NEW MAMA GLOW BUNDLE - Honey
Vitamin C Shower Gel & Carrot HCaste Lotion
url: https://shop.tiktok.com/gb/pdp/1729769062214441291
image: >-
https://p19-oec-eu-common-no.tiktokcdn-eu.com/tos-no1a-i-t5fjg24jzw-no...
price:
amount: 28.98
original: null
discount: null
currency: GBP
symbol: £
rating: 4.4
review_count: 28
sold_count: 422
seller:
id: '7495877270527576395'
name: Q7Paris Cosmetics and Beauty
logo: https://p16-oec-eu-common-useastred.tiktokcdn-eu.c...
brand: Q7
labels:
- Free 3-day delivery
video: null
rank: null
region: GB
'400':
description: Unsupported market or feature for the market
components:
schemas:
ShopCategoryResponse:
properties:
category:
anyOf:
- $ref: '#/components/schemas/ShopCategory'
- type: 'null'
default: null
children:
items:
$ref: '#/components/schemas/ShopCategory'
title: Children
type: array
products:
items:
$ref: '#/components/schemas/ShopProduct'
title: Products
type: array
region:
title: Region
type: string
required:
- region
title: ShopCategoryResponse
type: object
ShopCategory:
properties:
id:
title: Id
type: string
name:
anyOf:
- type: string
- type: 'null'
default: null
title: Name
slug:
anyOf:
- type: string
- type: 'null'
default: null
title: Slug
level:
anyOf:
- type: integer
- type: 'null'
default: null
title: Level
is_leaf:
anyOf:
- type: boolean
- type: 'null'
default: null
title: Is Leaf
parent_id:
anyOf:
- type: string
- type: 'null'
default: null
title: Parent Id
image:
anyOf:
- type: string
- type: 'null'
default: null
title: Image
url:
anyOf:
- type: string
- type: 'null'
default: null
title: Url
required:
- id
title: ShopCategory
type: object
ShopProduct:
properties:
product_id:
title: Product Id
type: string
title:
anyOf:
- type: string
- type: 'null'
default: null
title: Title
url:
title: Url
type: string
image:
anyOf:
- type: string
- type: 'null'
default: null
title: Image
price:
$ref: '#/components/schemas/ShopPrice'
rating:
anyOf:
- type: number
- type: 'null'
default: null
title: Rating
review_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Review Count
sold_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Sold Count
seller:
anyOf:
- $ref: '#/components/schemas/ShopSeller'
- type: 'null'
default: null
brand:
anyOf:
- type: string
- type: 'null'
default: null
title: Brand
labels:
items:
type: string
title: Labels
type: array
video:
anyOf:
- $ref: '#/components/schemas/ShopVideo'
- type: 'null'
default: null
rank:
anyOf:
- type: integer
- type: 'null'
default: null
title: Rank
required:
- product_id
- url
title: ShopProduct
type: object
ShopPrice:
properties:
amount:
anyOf:
- type: number
- type: 'null'
default: null
title: Amount
original:
anyOf:
- type: number
- type: 'null'
default: null
title: Original
discount:
anyOf:
- type: string
- type: 'null'
default: null
title: Discount
currency:
anyOf:
- type: string
- type: 'null'
default: null
title: Currency
symbol:
anyOf:
- type: string
- type: 'null'
default: null
title: Symbol
title: ShopPrice
type: object
ShopSeller:
properties:
id:
anyOf:
- type: string
- type: 'null'
default: null
title: Id
name:
anyOf:
- type: string
- type: 'null'
default: null
title: Name
logo:
anyOf:
- type: string
- type: 'null'
default: null
title: Logo
title: ShopSeller
type: object
ShopVideo:
description: The TikTok video a product card is bound to (search results only).
properties:
id:
title: Id
type: string
title:
anyOf:
- type: string
- type: 'null'
default: null
title: Title
author_name:
anyOf:
- type: string
- type: 'null'
default: null
title: Author Name
play_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Play Count
like_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Like Count
cover_url:
anyOf:
- type: string
- type: 'null'
default: null
title: Cover Url
video_url:
anyOf:
- type: string
- type: 'null'
default: null
title: Video Url
required:
- id
title: ShopVideo
type: object
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.