@@ -15434,6 +15434,155 @@ paths:
1543415434 summary: Search videos
1543515435 tags:
1543615436 - TikTok
15437+ /v1/tiktok/shop/categories:
15438+ get:
15439+ description: "Top-level TikTok Shop categories (US). Drill down with /shop/categories/{category_id}."
15440+ operationId: tiktok_tiktok_shop_root_categories
15441+ responses:
15442+ "200":
15443+ content:
15444+ application/json:
15445+ schema: {}
15446+ description: Successful Response
15447+ security:
15448+ - ApiKeyAuth: []
15449+ summary: TikTok Shop root categories
15450+ tags:
15451+ - TikTok
15452+ /v1/tiktok/shop/categories/{category_id}:
15453+ get:
15454+ description: A category's subcategories and its top products as TikTok Shop
15455+ ranks them (US).
15456+ operationId: tiktok_tiktok_shop_category_subcategories_top_products
15457+ parameters:
15458+ - explode: false
15459+ in: path
15460+ name: category_id
15461+ required: true
15462+ schema:
15463+ title: Category Id
15464+ type: string
15465+ style: simple
15466+ responses:
15467+ "200":
15468+ content:
15469+ application/json:
15470+ schema: {}
15471+ description: Successful Response
15472+ "422":
15473+ content:
15474+ application/json:
15475+ schema:
15476+ $ref: '#/components/schemas/HTTPValidationError'
15477+ description: Validation Error
15478+ security:
15479+ - ApiKeyAuth: []
15480+ summary: "TikTok Shop category: subcategories + top products"
15481+ tags:
15482+ - TikTok
15483+ /v1/tiktok/shop/products/{product_id}:
15484+ get:
15485+ description: |-
15486+ Full TikTok Shop product page (US): description, images, price, SKUs with stock, reviews,
15487+ shop and TikTok's AI summary.
15488+ operationId: tiktok_tiktok_shop_product_detail
15489+ parameters:
15490+ - explode: false
15491+ in: path
15492+ name: product_id
15493+ required: true
15494+ schema:
15495+ title: Product Id
15496+ type: string
15497+ style: simple
15498+ responses:
15499+ "200":
15500+ content:
15501+ application/json:
15502+ schema: {}
15503+ description: Successful Response
15504+ "422":
15505+ content:
15506+ application/json:
15507+ schema:
15508+ $ref: '#/components/schemas/HTTPValidationError'
15509+ description: Validation Error
15510+ security:
15511+ - ApiKeyAuth: []
15512+ summary: TikTok Shop product detail
15513+ tags:
15514+ - TikTok
15515+ /v1/tiktok/shop/ranking:
15516+ get:
15517+ description: TikTok Shop's own ranking of the best-selling products of the past
15518+ 30 days (US).
15519+ operationId: tiktok_tiktok_shop_best_sellers
15520+ parameters:
15521+ - description: Max products to return
15522+ explode: true
15523+ in: query
15524+ name: count
15525+ required: false
15526+ schema:
15527+ default: 20
15528+ description: Max products to return
15529+ maximum: 50
15530+ minimum: 1
15531+ title: Count
15532+ type: integer
15533+ style: form
15534+ responses:
15535+ "200":
15536+ content:
15537+ application/json:
15538+ schema: {}
15539+ description: Successful Response
15540+ "422":
15541+ content:
15542+ application/json:
15543+ schema:
15544+ $ref: '#/components/schemas/HTTPValidationError'
15545+ description: Validation Error
15546+ security:
15547+ - ApiKeyAuth: []
15548+ summary: TikTok Shop best sellers
15549+ tags:
15550+ - TikTok
15551+ /v1/tiktok/shop/search:
15552+ get:
15553+ description: |-
15554+ Keyword search over TikTok Shop products (US): products with their bound video, matching
15555+ shops, related searches and categories.
15556+ operationId: tiktok_search_tiktok_shop_products
15557+ parameters:
15558+ - description: "Keyword, e.g. 'wireless earbuds'"
15559+ explode: true
15560+ in: query
15561+ name: q
15562+ required: true
15563+ schema:
15564+ description: "Keyword, e.g. 'wireless earbuds'"
15565+ minLength: 1
15566+ title: Q
15567+ type: string
15568+ style: form
15569+ responses:
15570+ "200":
15571+ content:
15572+ application/json:
15573+ schema: {}
15574+ description: Successful Response
15575+ "422":
15576+ content:
15577+ application/json:
15578+ schema:
15579+ $ref: '#/components/schemas/HTTPValidationError'
15580+ description: Validation Error
15581+ security:
15582+ - ApiKeyAuth: []
15583+ summary: Search TikTok Shop products
15584+ tags:
15585+ - TikTok
1543715586 /v1/tiktok/trending/hashtags:
1543815587 get:
1543915588 description: Get trending hashtags (mobile Discover surface — view_count + creators).
0 commit comments