> ## 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 Store
> A TikTok Shop store's stats and its full product catalogue, cursor-paginated up to 50 per page.
`store` carries sold count, followers, rating and product count; `products` is one page of the catalogue (`count` up to 50) — pass back `next_cursor` as `cursor` until `has_more` is false. Any product's `seller.id` is the `seller_id`. US only.
**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/stores/{seller_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/stores/{seller_id}:
get:
tags:
- TikTok Shop
summary: Shop Store
description: >-
A store's stats (sold, followers, rating, product count) and one cursor
page of its product catalogue. Pass back `next_cursor` as `cursor` for
the next page. US only.
operationId: getTikTokShopStore
parameters:
- name: seller_id
in: path
required: true
schema:
type: string
description: Numeric seller id — any product's seller.id.
- name: region
in: query
schema:
type: string
default: US
description: Market — US only for this endpoint.
- name: cursor
in: query
schema:
type: string
description: Pass back the previous page's next_cursor.
- name: count
in: query
schema:
type: integer
default: 20
minimum: 1
maximum: 50
description: Products per page.
responses:
'200':
description: Shop Store
content:
application/json:
schema:
$ref: '#/components/schemas/ShopStoreResponse'
example:
store:
id: '7495993271965420185'
name: M.A.C Cosmetics Store
logo: >-
https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c2ec47e4b8294040889d46bbc848adec~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&t=555f072d&ps=933b5bde&shp=905da467&shcp=948674b7&idc=useast5&from=2422056039
url: >-
https://www.tiktok.com/shop/store/m-a-c-cosmetics-store/7495993271965420185
rating: 4.6
sold_count: 569848
product_count: 104
review_count: 35340
followers_count: 431296
video_count: 1398
products:
- product_id: '1731601510632886937'
title: >-
MAC Nude Icons Lip Duo - Lip Pencil + M·A·Cximal Sleek
Satin Lipstick
url: >-
https://shop.tiktok.com/us/pdp/m-a-c-nude-icons-lip-duo-long-lasting-hydrating-formula/1731601510632886937
image: >-
https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...
price:
amount: 35
original: 50
discount: 30%
currency: USD
symbol: $
rating: 4.4
review_count: 4421
sold_count: 75450
seller:
id: '7495993271965420185'
name: M.A.C Cosmetics Store
logo: https://p16-oec-general-useast5.ttcdn-us.com/tos-u...
brand: MAC
labels:
- Free shipping
video: null
rank: null
- product_id: '1731733629451997849'
title: MAC Doja Cat Lip Duo
url: >-
https://shop.tiktok.com/us/pdp/doja-cat-lip-duo-set-red-coral-shades-long-lasting/1731733629451997849
image: >-
https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...
price:
amount: 35
original: 50
discount: 30%
currency: USD
symbol: $
rating: 4.6
review_count: 3884
sold_count: 49364
seller:
id: '7495993271965420185'
name: M.A.C Cosmetics Store
logo: https://p16-oec-general-useast5.ttcdn-us.com/tos-u...
brand: MAC
labels:
- Free shipping
video: null
rank: null
total: 104
has_more: true
next_cursor: >-
10_WzQ4NzAsMjQwMDAwMDAsMTc1NTgwMzE4OTU0NiwiMTczMTY1MzE2NzcwODE0ODM3NyJd
region: US
'400':
description: Unsupported market or feature for the market
'404':
description: Unknown seller id
components:
schemas:
ShopStoreResponse:
properties:
store:
anyOf:
- $ref: '#/components/schemas/ShopStore'
- type: 'null'
default: null
products:
items:
$ref: '#/components/schemas/ShopProduct'
title: Products
type: array
total:
anyOf:
- type: integer
- type: 'null'
default: null
title: Total
has_more:
default: false
title: Has More
type: boolean
next_cursor:
anyOf:
- type: string
- type: 'null'
default: null
title: Next Cursor
region:
title: Region
type: string
required:
- region
title: ShopStoreResponse
type: object
ShopStore:
properties:
id:
title: Id
type: string
name:
anyOf:
- type: string
- type: 'null'
default: null
title: Name
logo:
anyOf:
- type: string
- type: 'null'
default: null
title: Logo
url:
anyOf:
- type: string
- type: 'null'
default: null
title: Url
rating:
anyOf:
- type: number
- type: 'null'
default: null
title: Rating
sold_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Sold Count
product_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Product Count
review_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Review Count
followers_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Followers Count
video_count:
anyOf:
- type: integer
- type: 'null'
default: null
title: Video Count
required:
- id
title: ShopStore
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
````