Skip to content

How to get TikTok Shop product data with an API

Updated · 3 steps

TikTok Shop publishes a price, star rating, review count and units sold for every product, which makes it a useful signal for product research and competitor tracking. These calls return that data for the US shop.

01

Search products by keyword

Returns the products on TikTok Shop's first results page for a keyword, up to about 25. Each product has its product_id, title, image, product_price_info, rate_info (score and review count), sold_info.sold_count and seller details.

GET /v1/tiktok/shop/search 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v1/tiktok/shop/search?query=shoes' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/tiktok/shop/search?query=shoes", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v1/tiktok/shop/search?query=shoes",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/tiktok/shop/search?query=shoes", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v1/tiktok/shop/search?query=shoes");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "query": "shoes",
  "total_products": 25,
  "products": [
    {
      "product_id": "1732456392275825151",
      "title": "Mens Nike Vapormax Plus",
      "image": "{…}",
      "product_price_info": "{…}",
      "rate_info": "{…}",
      "sold_info": "{…}",
      "seller_info": "{…}",
      "seo_url": "{…}"
    }
  ]
}
02

Get one product's full details

Pass a product URL to get its categories, seller, images, title and full product info.

GET /v1/tiktok/product 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v1/tiktok/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/tiktok/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v1/tiktok/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/tiktok/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v1/tiktok/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fgoli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo%2F1729587769570529799");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "categories": [
    {
      "category_id": "700645",
      "level": 1,
      "is_leaf": false,
      "parent_id": "0",
      "category_name": "Health",
      "name_key": "magellan_700645"
    }
  ],
  "sale_region": "US",
  "error_code": 0,
  "error_message": "success",
  "product_info": {
    "product_id": "1729587769570529799",
    "status": 1,
    "seller": {
      "seller_id": "7495794203056835079",
      "name": "Goli Nutrition",
      "avatar": "{…}",
      "product_count": 57
    },
    "product_base": {
      "title": "3 Bottles of Goli Ashwagandha & Vitamin D Gummy - Mixed Berry, KSM-66, Vegan, Plant Based,…",
      "images": [
        "{…}"
      ],
      "sold_count": 866687,
      "price": "{…}"
    },
    "sale_props": [
      "{…}"
    ],
    "skus": [
      "{…}"
    ],
    "product_detail_review": {
      "product_rating": 4.7,
      "review_count": 71544,
      "review_count_str": "71,544"
    },
    "seller_id": "7495794203056835079"
  },
  "shop_info": {
    "seller_id": "7495794203056835079",
    "sold_count": 5836446,
    "on_sell_product_count": 57,
    "review_count": 412231,
    "global_seller_id": "7495794203056835079",
    "global_sold_count": "5836446",
    "followers_count": "600899",
    "video_count": "5889",
    "enable_follow": true,
    "shop_name": "Goli Nutrition",
    "shop_logo": {
      "height": 300,
      "width": 300,
      "uri": "tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506",
      "url_list": [
        "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9…"
      ]
    },
    "shop_rating": "4.6",
    "…": "14 more fields"
  }
}
03

Read the product's reviews

Pass a product_id from step 1, or a product URL. Returns the first page of reviews (up to 5), with total_reviews and the star breakdown.

GET /v1/tiktok/shop/product/reviews 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v1/tiktok/shop/product/reviews?product_id=1732456392275825151' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/tiktok/shop/product/reviews?product_id=1732456392275825151", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v1/tiktok/shop/product/reviews?product_id=1732456392275825151",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/tiktok/shop/product/reviews?product_id=1732456392275825151", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v1/tiktok/shop/product/reviews?product_id=1732456392275825151");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "has_more": true,
  "total_reviews": "1526",
  "product_reviews": [
    {
      "review_id": "7676947073632864014",
      "product_id": "1731578642912612516",
      "sku_id": "1731578664610402468",
      "review_rating": 1,
      "review_time": "1787428531123",
      "is_verified_purchase": true,
      "is_incentivized_review": false,
      "product_name": "Potaroma Universal Cat Paw Trimmer for Kittens - ABS Plastic, 4-Size Adjustable Trimmer wi…",
      "reviewer_name": "L**G",
      "reviewer_avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/059791b6cefa94c1da04e09b1…",
      "review_text": "I purchased this nail clipper for my kitten thinking that it was going to make it easier t…",
      "display_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/ebf2df00e13d4e2d8…",
      "…": "3 more fields"
    }
  ],
  "review_ratings": {
    "review_count": "1526",
    "overall_score": 4.4,
    "rating_result": {
      "1": "100",
      "2": "51",
      "3": "94",
      "4": "180",
      "5": "1101"
    }
  }
}

Limits

Only US products are supported. Search and reviews return their first page only. For a shop's own catalogue, the shop products endpoint returns a store's details and its first 20 products.

What it costs

Each call costs 1 credit. A keyword with no results page returns a 404 at 0 credits, an empty page costs 0 credits, and a product with no reviews costs 0 credits.

Try it with 100 free credits

Sign up with an email address, no card. Credits never expire. Errors cost 0 credits, and each endpoint page lists exactly what it charges.