TikTok Shop API

Our TikTok Shop API allows you to scrape products from TikTok Shop search results. For each product, the API returns its ID, title, price and discount, rating and number of reviews, number of products sold, seller, badges, and more.

Search TikTok Shop with q, sort results with sort, and filter them like on TikTok Shop with deals, category_id, color_id, min_price, max_price, and rating. Results are the ones of TikTok Shop in the United States.

The API endpoint is https://serpapi.com/search?engine=tiktok_shop

Head to the playground for a live and interactive demo.

API parameters

Search query

Required

Parameter defines the query you want to search. You can use anything that you would use in a regular TikTok Shop search (e.g., coffee, phone case, or vitamin c serum).

Advanced filters

sort

Optional

Parameter defines the sorting of the results. It defaults to relevance.

Available options:
relevance - Relevance
best_seller - Best sellers
newest - Newest

TikTok Shop's Price low to high and Price high to low options aren't supported: TikTok Shop returns the same products in the same order for both, not sorted by price. Use min_price and max_price to filter by price instead.

deals

Optional

Parameter defines whether to only show products with deals, like TikTok Shop's Deals filter. It can be set to true or false (default).

TikTok Shop applies it loosely and also returns some products without a discount or deal label.

category_id

Optional

Parameter defines the categories of the products, like TikTok Shop's Categories filter. It's a comma-separated list of category IDs (e.g., 914824 for Drinks, or 914824,915336 for Drinks and Snacks). Category IDs are available in filters[].options[].category_id of the results.

color_id

Optional

Parameter defines the colors of the products, like TikTok Shop's Color filter. It's a comma-separated list of color IDs (e.g., 1001063 for Black, or 1001063,1001079 for Black and White). Color IDs are available in filters[].options[].color_id of the results.

min_price

Optional

Parameter defines the minimum price of the products, as a whole number of US dollars (e.g., 10).

TikTok Shop applies it loosely and also returns some products priced below it, often limited-time deals.

max_price

Optional

Parameter defines the maximum price of the products, as a whole number of US dollars (e.g., 50).

TikTok Shop applies it loosely and also returns some products priced above it.

rating

Optional

Parameter defines the minimum rating of the products, like TikTok Shop's Rating filter.

Available options:
4 - 4 Stars & Up

TikTok Shop applies it slightly loosely and also returns a few products rated below it.

Pagination

page

Optional

Value is used to get results on a specific page. (e.g., 1 (default) is the first page of results, 2 is the 2nd page of results, 3 is the 3rd page of results, etc.). TikTok Shop returns up to 30 results per page, and serpapi_pagination.next is only present when there's a next page.

SerpApi parameters

engine

Required

Set parameter to tiktok_shop to use the TikTok Shop API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the TikTok Shop results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a Markdown-formatted version optimized for LLMs and AI agents.

json_restrictor

Optional

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

API results

JSON results

JSON output includes structured data for Organic Results and Filters.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML results

This API does not have a full HTML response, only text. search_metadata.prettify_html_file contains a link to the prettified version of the result. It is displayed in the playground.

Markdown results

Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results in a token-efficient format using tables, markdown links, and YAML frontmatter.

To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.

API examples

Result for q: `coffee`

TikTok Shop returns up to 30 products per page. Products sold by verified shops have seller.verified, shown with a blue check on TikTok Shop, and like on TikTok Shop, products without reviews have no rating. The filters shown above the results are in filters, with SerpApi links to apply them. TikTok Shop ranks products slightly differently from one search to another, so the order of the results can change between searches.

JSON Example

{
  ...
  "organic_results": [
    {
      "product_id": "1732793362373447722",
      "title": "X2 RYZE SUPERFOODS Mushroom Coffee USDA Organic with 6 Adaptogenic Mushrooms and MCT Oil, USA Grown Instant Coffee for Better Energy, Focus, Digestion, Immunity with Lions Mane & Turkey Tail (30 servings)",
      "link": "https://shop.tiktok.com/us/pdp/1732793362373447722",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/cb57d5097e90469e8a5631f632e7c4e9~tplv-fhlh96nyum-crop-webp:1200:1200.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "seller": {
        "id": "7494983590604735530",
        "name": "SHEILAUN PHIA SHOP"
      },
      "sold": 1,
      "price": "$16.99",
      "extracted_price": 16.99,
      "badges": [
        "Limited time deal"
      ],
      "free_shipping": true
    },
    {
      "product_id": "1729433445907992834",
      "title": "RYZE SUPERFOODS Organic Mushroom Coffee Powder - USDA Organic Medium Roast, USA-Grown Instant Healthy Focus Beverage for Adults, Vegetarian, Gluten-Free, Dairy-Free, 6 Adaptogenic Mushrooms, Acacia Fiber, No Additives, 30 Servings",
      "link": "https://shop.tiktok.com/us/pdp/ryze-superfoods-mushroom-coffee-usda-organic-30-servings/1729433445907992834",
      "thumbnail": "https://p16-oec-general-useast8.ttcdn-us.com/tos-useast8-i-rt0ujvrtvp-tx2/1994b59c5a43474f8039f12df1fea71b~tplv-fhlh96nyum-crop-webp:929:1057.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "brand": "RYZE SUPERFOODS",
      "seller": {
        "id": "7495491684454205698",
        "name": "RYZE Superfoods",
        "verified": true
      },
      "rating": 4.7,
      "reviews": 7917,
      "sold": 56290,
      "price": "$58.49",
      "extracted_price": 58.49,
      "free_shipping": true
    },
    ...
  ],
  "filters": [
    {
      "name": "Promotions",
      "options": [
        {
          "name": "Deals",
          "deals": true,
          "serpapi_link": "https://serpapi.com/search.json?deals=true&engine=tiktok_shop&q=coffee"
        }
      ]
    },
    {
      "name": "Categories",
      "options": [
        {
          "name": "Drinks",
          "category_id": "914824",
          "serpapi_link": "https://serpapi.com/search.json?category_id=914824&engine=tiktok_shop&q=coffee"
        },
        {
          "name": "Baking",
          "category_id": "915208",
          "serpapi_link": "https://serpapi.com/search.json?category_id=915208&engine=tiktok_shop&q=coffee"
        },
        ...
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "current": 1,
    "next": "https://serpapi.com/search.json?engine=tiktok_shop&page=2&q=coffee"
  }
}

Result for q: `coffee` and sort: `best_seller`

sort sorts the results like TikTok Shop's Sort by menu: best_seller sorts them by number of products sold (sold), and newest shows the newest products first.

JSON Example

{
  ...
  "organic_results": [
    {
      "product_id": "1729687495043093429",
      "title": "Protein Loaded Coffee – Viral | Single Packet | 16oz Coffee Drink Mix | 10g Protein & 180mg Caffeine | Hot or Cold",
      "link": "https://shop.tiktok.com/us/pdp/protein-coffee-packets-by-brand-10g-protein-180mg-caffeine-16oz/1729687495043093429",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/14482dcc2f9e4e9da412ca06e4039cf8~tplv-fhlh96nyum-crop-webp:1024:1024.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "seller": {
        "id": "7495500842223700917",
        "name": "Caffeine, Candles & Chaos"
      },
      "rating": 4.8,
      "reviews": 47052,
      "sold": 1316358,
      "price": "$7.21",
      "extracted_price": 7.21
    },
    {
      "product_id": "1729385057785057965",
      "title": "Micro Ingredients Organic Instant 10 in 1 Mushroom Coffee Powder",
      "link": "https://shop.tiktok.com/us/pdp/mushroom-coffee-powder-by-micro-ingredients-organic-instant-blend-10-in-1/1729385057785057965",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/6f0465dd783e4425a0666dd1d4878381~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "brand": "Micro Ingredients",
      "seller": {
        "id": "7494949083499694765",
        "name": "Micro Ingredients",
        "verified": true
      },
      "rating": 4.7,
      "reviews": 29657,
      "sold": 224071,
      "price": "$24.95",
      "extracted_price": 24.95,
      "old_price": "$27.95",
      "extracted_old_price": 27.95,
      "discount": "-11%",
      "free_shipping": true
    },
    ...
  ],
  "serpapi_pagination": {
    "current": 1,
    "next": "https://serpapi.com/search.json?engine=tiktok_shop&page=2&q=coffee&sort=best_seller"
  }
}

Result for q: `water bottle`, deals: `true`, and rating: `4`

deals and rating apply TikTok Shop's Deals and 4 Stars & Up filters. Categories and colors are filtered with category_id and color_id, using the IDs in filters. Each option in filters has the parameters that apply it. Applied options are selected, and their serpapi_link removes them from the filters.

JSON Example

{
  ...
  "organic_results": [
    {
      "product_id": "1729450033205645687",
      "title": "WATERH Boost Smart Digital Tumbler Hydrojug - Durable Insulated Stainless Steel Vacuum Flask, 16ft App Sync, 90-135° Sip Tracking, Water Intake Tracker, Hydration Reminder, Wide Mouth Portable Cup, Travel/Gym Use, Back-to-School Gift with Free Sticker",
      "link": "https://shop.tiktok.com/us/pdp/smart-water-bottle-by-waterh-vacuum-insulated-stainless-steel-with-app/1729450033205645687",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e52acc58329248f1a9b6abd0bbf9177d~tplv-fhlh96nyum-crop-webp:1446:1500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "brand": "WATERH",
      "seller": {
        "id": "7495277265489332599",
        "name": "GetWaterH"
      },
      "rating": 4.7,
      "reviews": 4834,
      "sold": 38258,
      "price": "$54.99",
      "extracted_price": 54.99,
      "old_price": "$69.99",
      "extracted_old_price": 69.99,
      "discount": "-21%",
      "badges": [
        "Flash sale"
      ],
      "free_shipping": true
    },
    {
      "product_id": "1732461022720397801",
      "title": "HydroJug Traveler Limited Edition Insulated Stainless Steel Flask Tumbler Water Bottle - 32/40 Oz Reusable, Leak-Proof, Explosion-Proof, Heat Resistant, Cup Holder-Fit, Rubber Base, Cute Women's Sports Drinkware (Pink Handle)",
      "link": "https://shop.tiktok.com/us/pdp/hydrojug-traveler-insulated-tumbler-32-40-oz-leak-proof/1732461022720397801",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/cd542fd4b54f4ae687a087381da22e25~tplv-fhlh96nyum-crop-webp:1080:1439.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "seller": {
        "id": "7494689477799937513",
        "name": "Hydration Girl"
      },
      "rating": 4.8,
      "reviews": 52,
      "sold": 718,
      "price": "$38.98",
      "extracted_price": 38.98,
      "old_price": "$79.99",
      "extracted_old_price": 79.99,
      "discount": "-51%",
      "badges": [
        "Limited time deal"
      ]
    },
    ...
  ],
  "filters": [
    {
      "name": "Promotions",
      "options": [
        {
          "name": "Deals",
          "deals": true,
          "selected": true,
          "serpapi_link": "https://serpapi.com/search.json?engine=tiktok_shop&q=water+bottle&rating=4"
        }
      ]
    },
    {
      "name": "Rating",
      "options": [
        {
          "name": "4 Stars & Up",
          "rating": 4,
          "selected": true,
          "serpapi_link": "https://serpapi.com/search.json?deals=true&engine=tiktok_shop&q=water+bottle"
        }
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "current": 1,
    "next": "https://serpapi.com/search.json?deals=true&engine=tiktok_shop&page=2&q=water+bottle&rating=4"
  }
}

Result for q: `coffee`, min_price: `10`, and max_price: `20`

min_price and max_price filter the products by price, in whole US dollars, like TikTok Shop's price filters. The price ranges TikTok Shop suggests for the search are in the Price Range filter, with their min_price and max_price instead of an ID.

JSON Example

{
  ...
  "organic_results": [
    {
      "product_id": "1732793362373447722",
      "title": "X2 RYZE SUPERFOODS Mushroom Coffee USDA Organic with 6 Adaptogenic Mushrooms and MCT Oil, USA Grown Instant Coffee for Better Energy, Focus, Digestion, Immunity with Lions Mane & Turkey Tail (30 servings)",
      "link": "https://shop.tiktok.com/us/pdp/1732793362373447722",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/cb57d5097e90469e8a5631f632e7c4e9~tplv-fhlh96nyum-crop-webp:1200:1200.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "seller": {
        "id": "7494983590604735530",
        "name": "SHEILAUN PHIA SHOP"
      },
      "sold": 1,
      "price": "$16.99",
      "extracted_price": 16.99,
      "badges": [
        "Limited time deal"
      ],
      "free_shipping": true
    },
    {
      "product_id": "1732793487491109070",
      "title": "（Flash Sale 3 X）RYZE Mushroom Coffee USDA Organic with 6 Adaptogenic Mushrooms and MCT Oil, USA Grown Instant Coffee for Better Energy, Focus, Digestion, Immunity with Turkey Tail, Shiitake, Lion's Mane, 30 Servings",
      "link": "https://shop.tiktok.com/us/pdp/1732793487491109070",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/885e245508be46879af02116b15dd88e~tplv-fhlh96nyum-crop-webp:787:787.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "seller": {
        "id": "7494981797765350606",
        "name": "kristinamileshko5"
      },
      "sold": 1,
      "price": "$11.99",
      "extracted_price": 11.99,
      "badges": [
        "Limited time deal"
      ],
      "free_shipping": true
    },
    ...
  ],
  "filters": [
    {
      "name": "Price Range",
      "options": [
        {
          "name": "Under $25",
          "max_price": 25,
          "serpapi_link": "https://serpapi.com/search.json?engine=tiktok_shop&max_price=25&q=coffee"
        },
        {
          "name": "$25 - $30",
          "min_price": 25,
          "max_price": 30,
          "serpapi_link": "https://serpapi.com/search.json?engine=tiktok_shop&max_price=30&min_price=25&q=coffee"
        },
        {
          "name": "$30 - $50",
          "min_price": 30,
          "max_price": 50,
          "serpapi_link": "https://serpapi.com/search.json?engine=tiktok_shop&max_price=50&min_price=30&q=coffee"
        },
        {
          "name": "Over $50",
          "min_price": 50,
          "serpapi_link": "https://serpapi.com/search.json?engine=tiktok_shop&min_price=50&q=coffee"
        }
      ]
    },
    ...
  ],
  "serpapi_pagination": {
    "current": 1,
    "next": "https://serpapi.com/search.json?engine=tiktok_shop&max_price=20&min_price=10&page=2&q=coffee"
  }
}

Result for q: `coffee` and page: `2`

TikTok Shop loads 30 more products each time the end of the results is reached. page gets them: 2 for products 31 to 60, 3 for products 61 to 90, and so on. serpapi_pagination.next is only present when TikTok Shop has more products.

JSON Example

{
  ...
  "organic_results": [
    {
      "product_id": "1732792779933061251",
      "title": "X2 RYZE SUPERFOODS Mushroom Coffee USDA Organic with 6 Adaptogenic Mushrooms and MCT Oil, USA Grown Instant Coffee for Better Energy, Focus, Digestion, Immunity with Lions Mane & Turkey Tail (30 servings)",
      "link": "https://shop.tiktok.com/us/pdp/1732792779933061251",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/3535621d41ad41aa819f98e184e539ab~tplv-fhlh96nyum-crop-webp:1200:1200.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "seller": {
        "id": "7494980248804099203",
        "name": "DNOMAR"
      },
      "sold": 5,
      "price": "$16.99",
      "extracted_price": 16.99,
      "badges": [
        "Limited time deal"
      ],
      "free_shipping": true
    },
    {
      "product_id": "1732789735044321506",
      "title": "X2 RYZE SUPERFOODSMushroom Coffee USDAOrganic with 6 AdaptogenicMushrooms and MCT Oil,USA Grown Instant Coffee forBetter Energy, Focus,Digestion, Immunity withLions Mane & Turkey Tail (30servings)",
      "link": "https://shop.tiktok.com/us/pdp/1732789735044321506",
      "thumbnail": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d94a7ad52fb340a5b47a150ddc90b826~tplv-fhlh96nyum-crop-webp:1200:1200.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "seller": {
        "id": "7494987327489475810",
        "name": "CLARENCE DIXON  CLARENCE DIXON"
      },
      "sold": 9,
      "price": "$16.99",
      "extracted_price": 16.99,
      "old_price": "$28.99",
      "extracted_old_price": 28.99,
      "discount": "-41%",
      "badges": [
        "Limited time deal"
      ],
      "free_shipping": true
    },
    ...
  ],
  "serpapi_pagination": {
    "current": 2,
    "previous": "https://serpapi.com/search.json?engine=tiktok_shop&page=1&q=coffee",
    "next": "https://serpapi.com/search.json?engine=tiktok_shop&page=3&q=coffee"
  }
}

JSON structure overview

{
  ...
  "search_information": {
    "organic_results_state": "String - Fully empty when TikTok Shop hasn't returned any results."
  },
  "organic_results": [
    {
      "product_id": "String - TikTok Shop ID of the product.",
      "title": "String - Title of the product.",
      "link": "String - Link to the product on TikTok Shop.",
      "thumbnail": "String - Link to the image of the product.",
      "brand": "String - Brand of the product.",
      "seller": {
        "id": "String - TikTok Shop ID of the shop selling the product.",
        "name": "String - Name of the shop.",
        "verified": "Boolean - True for verified shops, shown with a blue check on TikTok Shop."
      },
      "rating": "Float - Average rating of the product, out of 5.",
      "reviews": "Integer - Number of reviews of the product.",
      "sold": "Integer - Number of products sold.",
      "price": "String - Price of the product, as displayed. For products with variations (e.g. sizes or colors), it's usually the lowest price of the variations.",
      "extracted_price": "Float - Price of the product.",
      "old_price": "String - Price of the product before the discount, as displayed.",
      "extracted_old_price": "Float - Price of the product before the discount.",
      "discount": "String - Discount of the product, as displayed. (Ex. -50%)",
      "badges": [
        "String - Badge of the product. (Ex. Limited time deal, Flash sale)"
      ],
      "free_shipping": "Boolean - True if the product ships free."
    }
  ],
  "filters": [
    {
      "name": "String - Name of the filter. (Ex. Promotions, Categories, Color, Price Range, Rating)",
      "options": [
        {
          "name": "String - Name of the option. (Ex. Deals, Drinks, Black, Under $25, 4 Stars & Up)",
          "deals": "Boolean - True for the Deals option, to use in deals.",
          "category_id": "String - ID of a category, to use in category_id.",
          "color_id": "String - ID of a color, to use in color_id.",
          "min_price": "Integer - Minimum price of a price range, to use in min_price.",
          "max_price": "Integer - Maximum price of a price range, to use in max_price.",
          "rating": "Integer - Minimum rating, to use in rating.",
          "selected": "Boolean - True if the option is applied.",
          "serpapi_link": "String - SerpApi link to the search with the option added to the applied filters, or removed if it's selected."
        }
      ]
    }
  ],
  "serpapi_pagination": {
    "current": "Integer - Current page.",
    "previous": "String - SerpApi link to the previous page.",
    "next": "String - SerpApi link to the next page. Missing when TikTok Shop has no more products."
  }
}

TikTok Shop API

API parameters

Search query

Advanced filters

Pagination

SerpApi parameters

API results

JSON results

HTML results

Markdown results

API examples

Result for q: coffee

Result for q: coffee and sort: best_seller

Result for q: water bottle, deals: true, and rating: 4

Result for q: coffee, min_price: 10, and max_price: 20

Result for q: coffee and page: 2

JSON structure overview

Result for q: `coffee`

Result for q: `coffee` and sort: `best_seller`

Result for q: `water bottle`, deals: `true`, and rating: `4`

Result for q: `coffee`, min_price: `10`, and max_price: `20`

Result for q: `coffee` and page: `2`