> ## 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 Search

> Keyword search over TikTok Shop products, with the TikTok video each listing is bound to, matching shops and related searches.

<Note>
  Search results carry `video` — the TikTok video driving the listing (`play_count`, `like_count`, `author_name`) — plus `brand`, matching `shops`, `related_searches` and `related_categories`.
</Note>

<Note>
  **US market only** — TikTok Shop resolves the market from the visitor's location and these endpoints read the US storefront (prices in USD). Lists return what the storefront page renders; there is no further pagination.
</Note>

<Note>
  Each request costs **5 credits**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/tiktok/shop/search
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/search:
    get:
      tags:
        - TikTok Shop
      summary: Shop Search
      description: >-
        Keyword search over TikTok Shop products: products with the TikTok video
        they are bound to and their brand, matching shops, related searches and
        related categories. US market only (prices in USD); lists carry what the
        storefront page renders, with no further pagination.
      operationId: searchTikTokShop
      parameters:
        - name: q
          in: query
          required: true
          schema:
            type: string
          description: Keyword, e.g. wireless earbuds.
      responses:
        '200':
          description: Shop Search
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShopSearchResponse'
              example:
                products:
                  - product_id: '1729470894545670276'
                    title: >-
                      【2026 New Production】CMF Buds 2a Wireless Bluetooth
                      Earbuds, 12.4 mm Custom Dynamic Driver, 42 dB Active Noise
                      Cancellation, 4 HD Mics with Clear Voice
                      Technology,summerwins tiktokshopbacktoschool,back to
                      school,back to school haul
                    url: >-
                      https://shop.tiktok.com/us/pdp/cmf-buds-wireless-bluetooth-earbuds-with-42db-noise-cancelling-35-5h-playtime/1729470894545670276
                    image: >-
                      https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b736159635ac4933b...
                    price:
                      amount: 49
                      original: null
                      discount: null
                      currency: USD
                      symbol: $
                    rating: 4.7
                    review_count: 3383
                    sold_count: 26801
                    seller:
                      id: '7495669706651568260'
                      name: CMF by Nothing
                      logo: >-
                        https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-o...
                    brand: CMF by Nothing
                    labels:
                      - Limited time deal
                    promo: null
                    video:
                      id: '7639063434667101470'
                      title: >-
                        Replying to @Goldfishing24 Jlab vs CMF @Nothing #music
                        #headphones #tiktokshop #tiktokmarketplace
                        #tiktokmademebuyit 
                      author_name: Isaac
                      play_count: 10168636
                      like_count: 112959
                      cover_url: >-
                        https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-...
                      video_url: >-
                        https://v16m-default.tiktokcdn-us.com/3931ad4a6475e6c6240056...
                    rank: null
                shops:
                  - id: '7495669706651568260'
                    name: CMF by Nothing
                    logo: >-
                      https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d83d7b129a314d90b95e583429db51cf~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&t=555f072d&ps=933b5bde&shp=905da467&shcp=d9d491bf&idc=useast5&from=2422056039
                  - id: '7494161853719414088'
                    name: JBL
                    logo: >-
                      https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2eae32bc80744404a8809b3fdc7e5a50~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&t=555f072d&ps=933b5bde&shp=905da467&shcp=d9d491bf&idc=useast5&from=2422056039
                related_searches:
                  - WirelessEarbuds
                  - Affordable Wireless Earbuds
                  - Wireless esrbuds
                  - earbuds wireless
                  - Earbuds
                  - Wireless gaming earbuds
                  - Earphone wireless earbuds
                  - earbuds wireless Airbuds
                  - Wireless earbud adaptor
                related_categories:
                  - id: '601990'
                    name: Headphones, Earphones & Accessories
                    slug: headphones-earphones-accessories
                    level: null
                    is_leaf: null
                    parent_id: null
                    image: null
                    url: >-
                      https://shop.tiktok.com/us/c/headphones-earphones-accessories/601990
                  - id: '602083'
                    name: Smart Watches
                    slug: smart-watches
                    level: null
                    is_leaf: null
                    parent_id: null
                    image: null
                    url: https://shop.tiktok.com/us/c/smart-watches/602083
                query: wireless earbuds
                region: US
components:
  schemas:
    ShopSearchResponse:
      properties:
        products:
          items:
            $ref: '#/components/schemas/ShopProduct'
          title: Products
          type: array
        shops:
          items:
            $ref: '#/components/schemas/ShopSeller'
          title: Shops
          type: array
        related_searches:
          items:
            type: string
          title: Related Searches
          type: array
        related_categories:
          items:
            $ref: '#/components/schemas/ShopCategory'
          title: Related Categories
          type: array
        query:
          title: Query
          type: string
        region:
          default: US
          title: Region
          type: string
      required:
        - query
      title: ShopSearchResponse
      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
        promo:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Promo
        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
    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
    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
    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
    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

````