Shop Store
curl --request GET \
--url https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"store": {
"id": "7495993271965420185",
"name": "M.A.C Cosmetics Store",
"logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c2ec47e4b8294040889d46bbc848adec~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&t=555f072d&ps=933b5bde&shp=905da467&shcp=948674b7&idc=useast5&from=2422056039",
"url": "https://www.tiktok.com/shop/store/m-a-c-cosmetics-store/7495993271965420185",
"rating": 4.6,
"sold_count": 569848,
"product_count": 104,
"review_count": 35340,
"followers_count": 431296,
"video_count": 1398
},
"products": [
{
"product_id": "1731601510632886937",
"title": "MAC Nude Icons Lip Duo - Lip Pencil + M·A·Cximal Sleek Satin Lipstick",
"url": "https://shop.tiktok.com/us/pdp/m-a-c-nude-icons-lip-duo-long-lasting-hydrating-formula/1731601510632886937",
"image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...",
"price": {
"amount": 35,
"original": 50,
"discount": "30%",
"currency": "USD",
"symbol": "$"
},
"rating": 4.4,
"review_count": 4421,
"sold_count": 75450,
"seller": {
"id": "7495993271965420185",
"name": "M.A.C Cosmetics Store",
"logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-u..."
},
"brand": "MAC",
"labels": [
"Free shipping"
],
"video": null,
"rank": null
},
{
"product_id": "1731733629451997849",
"title": "MAC Doja Cat Lip Duo",
"url": "https://shop.tiktok.com/us/pdp/doja-cat-lip-duo-set-red-coral-shades-long-lasting/1731733629451997849",
"image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...",
"price": {
"amount": 35,
"original": 50,
"discount": "30%",
"currency": "USD",
"symbol": "$"
},
"rating": 4.6,
"review_count": 3884,
"sold_count": 49364,
"seller": {
"id": "7495993271965420185",
"name": "M.A.C Cosmetics Store",
"logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-u..."
},
"brand": "MAC",
"labels": [
"Free shipping"
],
"video": null,
"rank": null
}
],
"total": 104,
"has_more": true,
"next_cursor": "10_WzQ4NzAsMjQwMDAwMDAsMTc1NTgwMzE4OTU0NiwiMTczMTY1MzE2NzcwODE0ODM3NyJd",
"region": "US"
}Shop
Shop Store
A TikTok Shop store’s stats and its full product catalogue, cursor-paginated up to 50 per page.
GET
/
v1
/
tiktok
/
shop
/
stores
/
{seller_id}
Shop Store
curl --request GET \
--url https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/tiktok/shop/stores/{seller_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"store": {
"id": "7495993271965420185",
"name": "M.A.C Cosmetics Store",
"logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c2ec47e4b8294040889d46bbc848adec~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&t=555f072d&ps=933b5bde&shp=905da467&shcp=948674b7&idc=useast5&from=2422056039",
"url": "https://www.tiktok.com/shop/store/m-a-c-cosmetics-store/7495993271965420185",
"rating": 4.6,
"sold_count": 569848,
"product_count": 104,
"review_count": 35340,
"followers_count": 431296,
"video_count": 1398
},
"products": [
{
"product_id": "1731601510632886937",
"title": "MAC Nude Icons Lip Duo - Lip Pencil + M·A·Cximal Sleek Satin Lipstick",
"url": "https://shop.tiktok.com/us/pdp/m-a-c-nude-icons-lip-duo-long-lasting-hydrating-formula/1731601510632886937",
"image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...",
"price": {
"amount": 35,
"original": 50,
"discount": "30%",
"currency": "USD",
"symbol": "$"
},
"rating": 4.4,
"review_count": 4421,
"sold_count": 75450,
"seller": {
"id": "7495993271965420185",
"name": "M.A.C Cosmetics Store",
"logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-u..."
},
"brand": "MAC",
"labels": [
"Free shipping"
],
"video": null,
"rank": null
},
{
"product_id": "1731733629451997849",
"title": "MAC Doja Cat Lip Duo",
"url": "https://shop.tiktok.com/us/pdp/doja-cat-lip-duo-set-red-coral-shades-long-lasting/1731733629451997849",
"image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-...",
"price": {
"amount": 35,
"original": 50,
"discount": "30%",
"currency": "USD",
"symbol": "$"
},
"rating": 4.6,
"review_count": 3884,
"sold_count": 49364,
"seller": {
"id": "7495993271965420185",
"name": "M.A.C Cosmetics Store",
"logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-u..."
},
"brand": "MAC",
"labels": [
"Free shipping"
],
"video": null,
"rank": null
}
],
"total": 104,
"has_more": true,
"next_cursor": "10_WzQ4NzAsMjQwMDAwMDAsMTc1NTgwMzE4OTU0NiwiMTczMTY1MzE2NzcwODE0ODM3NyJd",
"region": "US"
}store carries sold count, followers, rating and product count; products is one page of the catalogue (count up to 50) — pass back next_cursor as cursor until has_more is false. Any product’s seller.id is the seller_id. 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.
Authorizations
Path Parameters
Numeric seller id — any product's seller.id.
Query Parameters
Market — US only for this endpoint.
Pass back the previous page's next_cursor.
Products per page.
Required range:
1 <= x <= 50
