> ## 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 Deals Feed
> Curated TikTok Shop feeds — recommended-for-you and premium-offers — about 40 products each.
`recommended-for-you` and `premium-offers` are the storefront's curated deal feeds (about 40 products each). 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/deals/{deal}
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/deals/{deal}:
get:
tags:
- TikTok Shop
summary: Shop Deals Feed
description: >-
A curated storefront feed of about 40 products: `recommended-for-you` or
`premium-offers`. US only.
operationId: getTikTokShopDeals
parameters:
- name: deal
in: path
required: true
schema:
type: string
enum:
- recommended-for-you
- premium-offers
- name: region
in: query
schema:
type: string
default: US
description: Market — US only for this endpoint.
responses:
'200':
description: Shop Deals Feed
content:
application/json:
schema:
$ref: '#/components/schemas/ShopDealsResponse'
example:
deal: premium-offers
products:
- product_id: '1729494587354420231'
title: >-
JOYIN 4 Pack Stress Cube, 2'' High Density Cube Fidget
Toy, Stress Relief with Slow Rising Sensory Squishy Toys
for Kids Adults, Birthday Gifts, Party Favors, Classroom
Prizes for Boys Girls, Butter Stick Squishy
url: >-
https://shop.tiktok.com/us/pdp/stress-cube-joyin-4-pack-fidget-toys-slow-rising-fun-for-all/1729494587354420231
image: >-
https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...
price:
amount: 12.99
original: null
discount: null
currency: USD
symbol: $
rating: 4.1
review_count: 4143
sold_count: 38128
seller:
id: '7495151898716112903'
name: JOYIN
logo: https://p16-oec-general-useast5.ttcdn-us.com/tos-u...
brand: JOYIN
labels:
- Free shipping
video: null
rank: null
- product_id: '1731045839067714056'
title: >-
Geoorood Cat Water Fountain - 304 Steel Top Automatic
Water Feeder, 3.2L Large Capacity, Dual Flow Modes, 30-Day
Leak Free Pet Fountain for Multi-Cat Homes, Easy to
Clean,back to school
url: >-
https://shop.tiktok.com/us/pdp/cat-water-fountain-geoorood-108oz-with-dual-mode-design-20db-quiet-bpa-free-abs/1731045839067714056
image: >-
https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...
price:
amount: 23.26
original: 49.99
discount: 53%
currency: USD
symbol: $
rating: 4.7
review_count: 2639
sold_count: 16546
seller:
id: '7495483223861791240'
name: Geoorood Pet US
logo: https://p16-oec-general-useast5.ttcdn-us.com/tos-u...
brand: Geoorood
labels:
- Free shipping
video: null
rank: null
region: US
'400':
description: Unsupported market or feature for the market
components:
schemas:
ShopDealsResponse:
properties:
deal:
title: Deal
type: string
products:
items:
$ref: '#/components/schemas/ShopProduct'
title: Products
type: array
region:
title: Region
type: string
required:
- deal
- region
title: ShopDealsResponse
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
````