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.
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.
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; {
"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": "{…}"
}
]
} Get one product's full details
Pass a product URL to get its categories, seller, images, title and full product info.
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; {
"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"
}
} 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.
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; {
"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.