@scrapecreators/cli 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +241 -0
- package/api-config/apis.js +14559 -0
- package/api-config/instagram-apis.js +5753 -0
- package/api-config/tiktok-apis.js +17388 -0
- package/api-config/tiktok-shop-apis.js +1053 -0
- package/bin/check-lockfile-sync.js +42 -0
- package/bin/scrapecreators.js +4 -0
- package/package.json +48 -0
- package/src/api-client.js +71 -0
- package/src/auth.js +27 -0
- package/src/cli.js +78 -0
- package/src/command-registry.js +156 -0
- package/src/commands/agent.js +311 -0
- package/src/commands/api.js +49 -0
- package/src/commands/auth.js +69 -0
- package/src/commands/balance.js +40 -0
- package/src/commands/config.js +65 -0
- package/src/commands/list.js +52 -0
- package/src/config.js +23 -0
- package/src/interactive.js +148 -0
- package/src/output.js +400 -0
|
@@ -0,0 +1,1053 @@
|
|
|
1
|
+
export const tiktokShopApis = {
|
|
2
|
+
id: "tiktok-shop",
|
|
3
|
+
name: "TikTok Shop",
|
|
4
|
+
description: "Everything about TikTok Shop",
|
|
5
|
+
endpoints: [
|
|
6
|
+
{
|
|
7
|
+
name: "Shop Search",
|
|
8
|
+
method: "GET",
|
|
9
|
+
description: "Scrape TikTok Shop Products from a search!",
|
|
10
|
+
fullDescription: "Searches TikTok Shop for products matching a keyword query. Returns an array of product objects each with `title`, `cover` image, `url` (product page link), `price`, `sold_count`, `review_count`, `rating`, and `shop_name`. Paginate with `page`; filter by region.",
|
|
11
|
+
path: "/v1/tiktok/shop/search",
|
|
12
|
+
params: [
|
|
13
|
+
{
|
|
14
|
+
name: "query",
|
|
15
|
+
type: "string",
|
|
16
|
+
required: true,
|
|
17
|
+
description: "Term you want to search for",
|
|
18
|
+
placeholder: "shoes",
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
name: "page",
|
|
22
|
+
type: "number",
|
|
23
|
+
required: false,
|
|
24
|
+
description: "Page number to retrieve",
|
|
25
|
+
placeholder: "1",
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
name: "region",
|
|
29
|
+
type: "select",
|
|
30
|
+
options: [
|
|
31
|
+
"US",
|
|
32
|
+
"GB",
|
|
33
|
+
"DE",
|
|
34
|
+
"FR",
|
|
35
|
+
"IT",
|
|
36
|
+
"ID",
|
|
37
|
+
"MY",
|
|
38
|
+
"MX",
|
|
39
|
+
"PH",
|
|
40
|
+
"SG",
|
|
41
|
+
"ES",
|
|
42
|
+
"TH",
|
|
43
|
+
"VN",
|
|
44
|
+
"BR",
|
|
45
|
+
"JP",
|
|
46
|
+
"IE",
|
|
47
|
+
],
|
|
48
|
+
placeholder: "US",
|
|
49
|
+
description:
|
|
50
|
+
"Region to search shop products in.",
|
|
51
|
+
},
|
|
52
|
+
],
|
|
53
|
+
sampleResponse: {
|
|
54
|
+
success: true,
|
|
55
|
+
query: "shoes",
|
|
56
|
+
total_products: 100,
|
|
57
|
+
products: [
|
|
58
|
+
{
|
|
59
|
+
product_id: "1730213444857467838",
|
|
60
|
+
title: "Crocs Adult Classic Clogs",
|
|
61
|
+
image: {
|
|
62
|
+
height: 1200,
|
|
63
|
+
width: 1200,
|
|
64
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/b16ea2605a0d4708af7cbc3a1dd03624",
|
|
65
|
+
url_list: [
|
|
66
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b16ea2605a0d4708af7cbc3a1dd03624~tplv-fhlh96nyum-crop-webp:1200:1200.webp?dr=12190&from=2378011839&idc=useast5&ps=933b5bde&shcp=a6e80448&shp=8dbd94bf&t=555f072d",
|
|
67
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b16ea2605a0d4708af7cbc3a1dd03624~tplv-fhlh96nyum-crop-webp:1200:1200.webp?dr=12190&from=2378011839&idc=useast5&ps=933b5bde&shcp=a6e80448&shp=8dbd94bf&t=555f072d",
|
|
68
|
+
],
|
|
69
|
+
},
|
|
70
|
+
product_price_info: {
|
|
71
|
+
sku_id: "1730213454432146366",
|
|
72
|
+
symbol_position: 1,
|
|
73
|
+
show_currency_space: false,
|
|
74
|
+
currency_show_mode: 1,
|
|
75
|
+
currency_name: "USD",
|
|
76
|
+
currency_symbol: "$",
|
|
77
|
+
sale_price_decimal: "49.99",
|
|
78
|
+
sale_price_format: "49.99",
|
|
79
|
+
single_product_price_format: "49.99",
|
|
80
|
+
single_product_price_decimal: "49.99",
|
|
81
|
+
sale_price_integer_part_format: "49",
|
|
82
|
+
sale_price_decimal_part_format: "99",
|
|
83
|
+
decimal_point_symbol: ".",
|
|
84
|
+
promotion_deduction_details: {},
|
|
85
|
+
},
|
|
86
|
+
rate_info: {
|
|
87
|
+
score: 4.8,
|
|
88
|
+
review_count: "2493",
|
|
89
|
+
},
|
|
90
|
+
sold_info: {
|
|
91
|
+
sold_count: 24737,
|
|
92
|
+
},
|
|
93
|
+
seller_info: {
|
|
94
|
+
seller_id: "7495832567110863806",
|
|
95
|
+
shop_name: "Crocs",
|
|
96
|
+
shop_logo: {
|
|
97
|
+
height: 300,
|
|
98
|
+
width: 300,
|
|
99
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/0e1e83bcdab948b9aa9e6474e87a8a80",
|
|
100
|
+
url_list: [
|
|
101
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/0e1e83bcdab948b9aa9e6474e87a8a80~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast5&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d",
|
|
102
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/0e1e83bcdab948b9aa9e6474e87a8a80~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast5&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d",
|
|
103
|
+
],
|
|
104
|
+
},
|
|
105
|
+
},
|
|
106
|
+
seo_url: {
|
|
107
|
+
updated_at: "1754122673333",
|
|
108
|
+
canonical_url:
|
|
109
|
+
"https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs-lightweight-slip-on-shoes-with-ventilation/1730213444857467838",
|
|
110
|
+
slug: "classic-clogs-by-crocs-lightweight-slip-on-shoes-with-ventilation",
|
|
111
|
+
type: 2,
|
|
112
|
+
version: 2,
|
|
113
|
+
},
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
product_id: "1729416431099876154",
|
|
117
|
+
title:
|
|
118
|
+
"Men's Running Shoes Blade Tennis Walking Fashion Sneakers Breathable NonSlip Gym Sports Work Trainers, Perfectfor Students and Outdoor Sport Runner Closed Sports Shoes Walking Shoes Casual Training Footwear Athletic Outdoorfun",
|
|
119
|
+
image: {
|
|
120
|
+
height: 800,
|
|
121
|
+
width: 800,
|
|
122
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/6849eb2b077845f08fb846a49385bba7",
|
|
123
|
+
url_list: [
|
|
124
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/6849eb2b077845f08fb846a49385bba7~tplv-fhlh96nyum-crop-webp:800:800.webp?dr=12190&from=2378011839&idc=useast5&ps=933b5bde&shcp=a6e80448&shp=8dbd94bf&t=555f072d",
|
|
125
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/6849eb2b077845f08fb846a49385bba7~tplv-fhlh96nyum-crop-webp:800:800.webp?dr=12190&from=2378011839&idc=useast5&ps=933b5bde&shcp=a6e80448&shp=8dbd94bf&t=555f072d",
|
|
126
|
+
],
|
|
127
|
+
},
|
|
128
|
+
product_price_info: {
|
|
129
|
+
sku_id: "1729416431099941690",
|
|
130
|
+
symbol_position: 1,
|
|
131
|
+
show_currency_space: false,
|
|
132
|
+
currency_show_mode: 1,
|
|
133
|
+
currency_name: "USD",
|
|
134
|
+
currency_symbol: "$",
|
|
135
|
+
sale_price_decimal: "19.99",
|
|
136
|
+
origin_price_decimal: "39.99",
|
|
137
|
+
sale_price_format: "19.99",
|
|
138
|
+
origin_price_format: "39.99",
|
|
139
|
+
discount_format: "50%",
|
|
140
|
+
discount_decimal: "0.5",
|
|
141
|
+
reduce_price_format: "Saving $20.00",
|
|
142
|
+
single_product_price_format: "19.99",
|
|
143
|
+
single_product_price_decimal: "19.99",
|
|
144
|
+
sale_price_integer_part_format: "19",
|
|
145
|
+
sale_price_decimal_part_format: "99",
|
|
146
|
+
decimal_point_symbol: ".",
|
|
147
|
+
promotion_deduction_details: {
|
|
148
|
+
seller_subtotal_deduction: "20.00",
|
|
149
|
+
seller_subtotal_deduction_decimal: "20",
|
|
150
|
+
},
|
|
151
|
+
},
|
|
152
|
+
rate_info: {
|
|
153
|
+
score: 4.2,
|
|
154
|
+
review_count: "5705",
|
|
155
|
+
},
|
|
156
|
+
sold_info: {
|
|
157
|
+
sold_count: 61277,
|
|
158
|
+
},
|
|
159
|
+
seller_info: {
|
|
160
|
+
seller_id: "7495432602243337018",
|
|
161
|
+
shop_name: "Mevlzz",
|
|
162
|
+
shop_logo: {
|
|
163
|
+
height: 300,
|
|
164
|
+
width: 300,
|
|
165
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/90310f23f7ae40a4aa3c10b058612edd",
|
|
166
|
+
url_list: [
|
|
167
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/90310f23f7ae40a4aa3c10b058612edd~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast5&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d",
|
|
168
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/90310f23f7ae40a4aa3c10b058612edd~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast5&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d",
|
|
169
|
+
],
|
|
170
|
+
},
|
|
171
|
+
},
|
|
172
|
+
seo_url: {
|
|
173
|
+
updated_at: "1746398123415",
|
|
174
|
+
canonical_url:
|
|
175
|
+
"https://www.tiktok.com/shop/pdp/mens-running-shoes-mevlzz-breathable-lightweight-lace-up-trainers/1729416431099876154",
|
|
176
|
+
slug: "mens-running-shoes-mevlzz-breathable-lightweight-lace-up-trainers",
|
|
177
|
+
type: 2,
|
|
178
|
+
version: 2,
|
|
179
|
+
},
|
|
180
|
+
},
|
|
181
|
+
],
|
|
182
|
+
},
|
|
183
|
+
},
|
|
184
|
+
{
|
|
185
|
+
name: "Shop Products",
|
|
186
|
+
method: "GET",
|
|
187
|
+
description:
|
|
188
|
+
"Get the products from a TikTok Shop. This endpoint costs 1 credit per request. Use the cursor from the response to paginate through results.",
|
|
189
|
+
fullDescription: "Lists all products from a specific TikTok Shop store by its URL. Returns an array of product objects each with `title`, `cover` images, `url`, `price` info, `sold_count`, `review_count`, and `rating`. Paginate with `cursor` from the previous response; filter by region.",
|
|
190
|
+
path: "/v1/tiktok/shop/products",
|
|
191
|
+
params: [
|
|
192
|
+
{
|
|
193
|
+
name: "url",
|
|
194
|
+
required: true,
|
|
195
|
+
type: "string",
|
|
196
|
+
description: "The TikTok Shop store URL.",
|
|
197
|
+
placeholder:
|
|
198
|
+
"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079",
|
|
199
|
+
},
|
|
200
|
+
{
|
|
201
|
+
name: "cursor",
|
|
202
|
+
type: "string",
|
|
203
|
+
required: false,
|
|
204
|
+
description:
|
|
205
|
+
"Cursor parameter from the previous response to retrieve the next page of products. Omit for the first page.",
|
|
206
|
+
placeholder: "",
|
|
207
|
+
},
|
|
208
|
+
{
|
|
209
|
+
name: "region",
|
|
210
|
+
type: "select",
|
|
211
|
+
options: [
|
|
212
|
+
"US",
|
|
213
|
+
"GB",
|
|
214
|
+
"DE",
|
|
215
|
+
"FR",
|
|
216
|
+
"IT",
|
|
217
|
+
"ID",
|
|
218
|
+
"MY",
|
|
219
|
+
"MX",
|
|
220
|
+
"PH",
|
|
221
|
+
"SG",
|
|
222
|
+
"ES",
|
|
223
|
+
"TH",
|
|
224
|
+
"VN",
|
|
225
|
+
"BR",
|
|
226
|
+
"JP",
|
|
227
|
+
"IE",
|
|
228
|
+
],
|
|
229
|
+
placeholder: "US",
|
|
230
|
+
description:
|
|
231
|
+
"Region to get shop products from. Defaults to US if not provided.",
|
|
232
|
+
},
|
|
233
|
+
],
|
|
234
|
+
sampleResponse: {
|
|
235
|
+
success: true,
|
|
236
|
+
shopInfo: {
|
|
237
|
+
seller_id: "7495794203056835079",
|
|
238
|
+
sold_count: 3767605,
|
|
239
|
+
on_sell_product_count: 36,
|
|
240
|
+
review_count: 284185,
|
|
241
|
+
global_seller_id: "7495794203056835079",
|
|
242
|
+
global_sold_count: "3767605",
|
|
243
|
+
followers_count: "237879",
|
|
244
|
+
video_count: "2413",
|
|
245
|
+
enable_follow: true,
|
|
246
|
+
shop_name: "Goli Nutrition",
|
|
247
|
+
shop_logo: {
|
|
248
|
+
height: 300,
|
|
249
|
+
width: 300,
|
|
250
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506",
|
|
251
|
+
url_list: [
|
|
252
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&from=2422056039&idc=useast8&ps=933b5bde&shcp=a6e80448&shp=905da467&t=555f072d",
|
|
253
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&from=2422056039&idc=useast8&ps=933b5bde&shcp=a6e80448&shp=905da467&t=555f072d",
|
|
254
|
+
],
|
|
255
|
+
},
|
|
256
|
+
shop_rating: "4.6",
|
|
257
|
+
shop_link:
|
|
258
|
+
"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079",
|
|
259
|
+
format_sold_count: "3.7M",
|
|
260
|
+
region: "US",
|
|
261
|
+
display_on_sell_product_count: "36",
|
|
262
|
+
format_global_sold_count: "3.7M",
|
|
263
|
+
shop_slogan: "Health Simple✨\nVegan. Gluten-Free. Non-GMO.",
|
|
264
|
+
format_followers_count: "237.8K+",
|
|
265
|
+
format_video_count: "2413",
|
|
266
|
+
store_sub_score: [
|
|
267
|
+
{
|
|
268
|
+
score: 0.9967,
|
|
269
|
+
type: 1,
|
|
270
|
+
score_percentage: "100",
|
|
271
|
+
high_light_tag: 1,
|
|
272
|
+
platform_rate_type: 1,
|
|
273
|
+
},
|
|
274
|
+
{
|
|
275
|
+
score: 0.5020439123674718,
|
|
276
|
+
type: 2,
|
|
277
|
+
score_percentage: "50",
|
|
278
|
+
high_light_tag: 0,
|
|
279
|
+
platform_rate_type: 0,
|
|
280
|
+
},
|
|
281
|
+
{
|
|
282
|
+
score: 0.888,
|
|
283
|
+
type: 3,
|
|
284
|
+
score_percentage: "89",
|
|
285
|
+
platform_rate_type: 0,
|
|
286
|
+
},
|
|
287
|
+
],
|
|
288
|
+
worst_rating: "0",
|
|
289
|
+
best_rating: "5",
|
|
290
|
+
creator_name: "Goli® Nutrition",
|
|
291
|
+
desc: "Shop Goli Nutrition on TikTok Shop! 3.7M sold, 237.8K+ followers. 89+% positive feedback. 50+% Ships in 48h, 100% replies in 24h. Join the trend!",
|
|
292
|
+
},
|
|
293
|
+
products: [
|
|
294
|
+
{
|
|
295
|
+
product_id: "1729527313880355335",
|
|
296
|
+
title:
|
|
297
|
+
"Goli Ashwagandha & Vitamin D Gummy - Mixed Berry, KSM-66, Vegan, Plant Based, Non-GMO, Gluten-Free & Gelatin Free. America's #1 Ashwagandha Brand",
|
|
298
|
+
image: {
|
|
299
|
+
height: 1500,
|
|
300
|
+
width: 1500,
|
|
301
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/30fc1338a2bf474a9d252a790e4c119f",
|
|
302
|
+
url_list: [
|
|
303
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/30fc1338a2bf474a9d252a790e4c119f~tplv-fhlh96nyum-crop-webp:1500:1500.webp?dr=12190&from=2378011839&idc=useast8&ps=933b5bde&shcp=905da467&shp=8dbd94bf&t=555f072d",
|
|
304
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/30fc1338a2bf474a9d252a790e4c119f~tplv-fhlh96nyum-crop-webp:1500:1500.webp?dr=12190&from=2378011839&idc=useast8&ps=933b5bde&shcp=905da467&shp=8dbd94bf&t=555f072d",
|
|
305
|
+
],
|
|
306
|
+
},
|
|
307
|
+
product_price_info: {
|
|
308
|
+
sku_id: "1729527298861535751",
|
|
309
|
+
symbol_position: 1,
|
|
310
|
+
show_currency_space: false,
|
|
311
|
+
currency_show_mode: 1,
|
|
312
|
+
currency_name: "USD",
|
|
313
|
+
currency_symbol: "$",
|
|
314
|
+
sale_price_decimal: "14.96",
|
|
315
|
+
origin_price_decimal: "24.99",
|
|
316
|
+
sale_price_format: "14.96",
|
|
317
|
+
origin_price_format: "24.99",
|
|
318
|
+
discount_format: "40%",
|
|
319
|
+
discount_decimal: "0.4",
|
|
320
|
+
reduce_price_format: "Saving $10.03",
|
|
321
|
+
single_product_price_format: "14.96",
|
|
322
|
+
single_product_price_decimal: "14.96",
|
|
323
|
+
sale_price_integer_part_format: "14",
|
|
324
|
+
sale_price_decimal_part_format: "96",
|
|
325
|
+
decimal_point_symbol: ".",
|
|
326
|
+
promotion_deduction_details: {
|
|
327
|
+
seller_subtotal_deduction: "10.03",
|
|
328
|
+
seller_subtotal_deduction_decimal: "10.03",
|
|
329
|
+
},
|
|
330
|
+
},
|
|
331
|
+
rate_info: {
|
|
332
|
+
score: 4.5,
|
|
333
|
+
review_count: "91316",
|
|
334
|
+
},
|
|
335
|
+
sold_info: {
|
|
336
|
+
sold_count: 1235089,
|
|
337
|
+
},
|
|
338
|
+
seller_info: {
|
|
339
|
+
seller_id: "7495794203056835079",
|
|
340
|
+
shop_name: "Goli Nutrition",
|
|
341
|
+
shop_logo: {
|
|
342
|
+
height: 300,
|
|
343
|
+
width: 300,
|
|
344
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506",
|
|
345
|
+
url_list: [
|
|
346
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast8&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d",
|
|
347
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast8&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d",
|
|
348
|
+
],
|
|
349
|
+
},
|
|
350
|
+
},
|
|
351
|
+
seo_url: {
|
|
352
|
+
updated_at: "1754035613102",
|
|
353
|
+
canonical_url:
|
|
354
|
+
"https://www.tiktok.com/shop/pdp/ashwagandha-gummies-by-goli-ksm-66-mixed-berry-vegan-non-gmo/1729527313880355335",
|
|
355
|
+
slug: "ashwagandha-gummies-by-goli-ksm-66-mixed-berry-vegan-non-gmo",
|
|
356
|
+
type: 2,
|
|
357
|
+
version: 2,
|
|
358
|
+
},
|
|
359
|
+
},
|
|
360
|
+
],
|
|
361
|
+
has_more: true,
|
|
362
|
+
cursor: "WzExMzg1LCIxNzMxMDMxNzc2NDk3MDc4NzkxIl0=",
|
|
363
|
+
},
|
|
364
|
+
},
|
|
365
|
+
{
|
|
366
|
+
name: "Product Details",
|
|
367
|
+
method: "GET",
|
|
368
|
+
description:
|
|
369
|
+
"Get the details of a TikTok Shop Product! Get the exact amount of stock the product has, related tiktok videos promoting the product, and more!",
|
|
370
|
+
fullDescription: "Fetches full details for a specific TikTok Shop product by its URL, including stock levels and affiliate videos. Returns `product_info` with `product_base` (title, images, sold_count, price), `skus` (variants with exact `stock` counts), and `product_detail_review` (product_rating, review_count, sample reviews); also returns `shop_info` (shop_name, shop_rating, followers_count) and `related_videos` (affiliate TikToks promoting the product).",
|
|
371
|
+
path: "/v1/tiktok/product",
|
|
372
|
+
params: [
|
|
373
|
+
{
|
|
374
|
+
name: "url",
|
|
375
|
+
required: true,
|
|
376
|
+
type: "string",
|
|
377
|
+
description: "The URL of the product to get details for.",
|
|
378
|
+
placeholder:
|
|
379
|
+
"https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799",
|
|
380
|
+
},
|
|
381
|
+
{
|
|
382
|
+
name: "get_related_videos",
|
|
383
|
+
required: false,
|
|
384
|
+
type: "string",
|
|
385
|
+
description:
|
|
386
|
+
"Whether to get related videos for the product. These are affiliate videos promoting the product.",
|
|
387
|
+
placeholder: "false",
|
|
388
|
+
},
|
|
389
|
+
{
|
|
390
|
+
name: "region",
|
|
391
|
+
required: false,
|
|
392
|
+
type: "string",
|
|
393
|
+
description:
|
|
394
|
+
"Region the proxy will be set to so you can access products from that country. Use 2 letter country codes like US, GB, FR, etc. For England, don't use UK, use GB.",
|
|
395
|
+
placeholder: "US",
|
|
396
|
+
},
|
|
397
|
+
],
|
|
398
|
+
sampleResponse: {
|
|
399
|
+
success: true,
|
|
400
|
+
categories: [
|
|
401
|
+
{
|
|
402
|
+
category_id: "601450",
|
|
403
|
+
level: 1,
|
|
404
|
+
is_leaf: false,
|
|
405
|
+
parent_id: "0",
|
|
406
|
+
category_name: "Beauty & Personal Care",
|
|
407
|
+
name_key: "magellan_601450",
|
|
408
|
+
},
|
|
409
|
+
],
|
|
410
|
+
sale_region: "US",
|
|
411
|
+
error_code: 0,
|
|
412
|
+
error_message: "",
|
|
413
|
+
product_info: {
|
|
414
|
+
product_id: "1730383241618035288",
|
|
415
|
+
status: 1,
|
|
416
|
+
seller: {
|
|
417
|
+
seller_id: "7496021452055022168",
|
|
418
|
+
name: "Manspot",
|
|
419
|
+
avatar: {
|
|
420
|
+
height: 300,
|
|
421
|
+
width: 300,
|
|
422
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc",
|
|
423
|
+
url_list: [
|
|
424
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-png:300:300.png?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=6ce186a1&shp=905da467&t=555f072d",
|
|
425
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-png:300:300.png?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=6ce186a1&shp=905da467&t=555f072d",
|
|
426
|
+
],
|
|
427
|
+
},
|
|
428
|
+
product_count: 14,
|
|
429
|
+
seller_location: "United States of America",
|
|
430
|
+
tiktok_id: "7098283607022158891",
|
|
431
|
+
tiktok_url: "https://www.tiktok.com/@7098283607022158891",
|
|
432
|
+
},
|
|
433
|
+
product_base: {
|
|
434
|
+
title:
|
|
435
|
+
"【dealsforyoudays】Manspot Electric Body Hair Razor for Men - USB Rechargeable, Waterproof, Replaceable Ceramic Heads, Ultra-Smooth Shaving, Cordless Trimmer for Grooming Routine",
|
|
436
|
+
desc_video: {
|
|
437
|
+
id: "v12d52gd0030ctp3lknog65q8llkgcng",
|
|
438
|
+
duration: 45.12,
|
|
439
|
+
post_url:
|
|
440
|
+
"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-afa798-tx/o8ZA1q3RIWBxiuEE26yRtg6vSIOIwvi4uUM0S~tplv-noop.image?t=9276707c&x-expires=1754373510&x-signature=MsmTJcnrIme3jsFlNSt2inH%2FpJQ%3D",
|
|
441
|
+
media_type: "video",
|
|
442
|
+
video_infos: [
|
|
443
|
+
{
|
|
444
|
+
main_url:
|
|
445
|
+
"https://v16m-default.tiktokcdn-us.com/01ffc8343c2e3127afb0726eff95ad96/68919d86/video/tos/useast5/tos-useast5-v-afa798-tx/owOtyWSdi4731vMSvI96iQRMUyvIwE0IgZBC6/?a=0&bti=PDM8QDI2M2A%3D&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=832&bt=416&cs=0&ds=6&ft=GS-jnInz7Th6_-fKXq8Zmo&mime_type=video_mp4&qs=0&rc=ZTtnNTlkaDdkNTM6MzQ0M0BpamZub3Q5cm42dzMzZzVnNEAtYjRgNDY2Xi4xYl5eMWIwYSNrZGk1MmRraW1gMC1kMi9zcw%3D%3D&vvpl=1&l=202508042357441758B7D2E7DB9E01F44C&btag=e00088000",
|
|
446
|
+
backup_url:
|
|
447
|
+
"https://v16m-default.tiktokcdn-us.com/01ffc8343c2e3127afb0726eff95ad96/68919d86/video/tos/useast5/tos-useast5-v-afa798-tx/owOtyWSdi4731vMSvI96iQRMUyvIwE0IgZBC6/?a=0&bti=PDM8QDI2M2A%3D&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=832&bt=416&cs=0&ds=6&ft=GS-jnInz7Th6_-fKXq8Zmo&mime_type=video_mp4&qs=0&rc=ZTtnNTlkaDdkNTM6MzQ0M0BpamZub3Q5cm42dzMzZzVnNEAtYjRgNDY2Xi4xYl5eMWIwYSNrZGk1MmRraW1gMC1kMi9zcw%3D%3D&vvpl=1&l=202508042357441758B7D2E7DB9E01F44C&btag=e00088000",
|
|
448
|
+
url_expire: 1754373510,
|
|
449
|
+
width: 1024,
|
|
450
|
+
height: 576,
|
|
451
|
+
file_hash: "19737dc9ddb53c96371d9bb7c79fd1fd",
|
|
452
|
+
format: "mp4",
|
|
453
|
+
size: 2408193,
|
|
454
|
+
bitrate: 426984,
|
|
455
|
+
video_quality: "normal",
|
|
456
|
+
},
|
|
457
|
+
],
|
|
458
|
+
},
|
|
459
|
+
images: [
|
|
460
|
+
{
|
|
461
|
+
height: 800,
|
|
462
|
+
width: 800,
|
|
463
|
+
thumb_uri:
|
|
464
|
+
"tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc",
|
|
465
|
+
thumb_url_list: [
|
|
466
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
467
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
468
|
+
],
|
|
469
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc",
|
|
470
|
+
url_list: [
|
|
471
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
472
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
473
|
+
],
|
|
474
|
+
},
|
|
475
|
+
],
|
|
476
|
+
sold_count: 7160,
|
|
477
|
+
price: {
|
|
478
|
+
original_price: "$3?",
|
|
479
|
+
real_price: "$2?",
|
|
480
|
+
discount: "-47%",
|
|
481
|
+
need_icon: false,
|
|
482
|
+
is_interval_price: false,
|
|
483
|
+
show_hot_zone: false,
|
|
484
|
+
min_sku_price: "2?",
|
|
485
|
+
max_sku_price: "",
|
|
486
|
+
currency: "USD",
|
|
487
|
+
min_sku_original_price: "39.99",
|
|
488
|
+
panel_schema: "",
|
|
489
|
+
currency_symbol: "$",
|
|
490
|
+
symbol_position: 1,
|
|
491
|
+
da_info: '{"price_show_tag":"","discount_percentage":"47"}',
|
|
492
|
+
},
|
|
493
|
+
},
|
|
494
|
+
sale_props: [
|
|
495
|
+
{
|
|
496
|
+
prop_id: "100000",
|
|
497
|
+
prop_name: "Color",
|
|
498
|
+
has_image: true,
|
|
499
|
+
sale_prop_values: [
|
|
500
|
+
{
|
|
501
|
+
prop_value_id: "6926865445131749121",
|
|
502
|
+
prop_value: "Black",
|
|
503
|
+
image: {
|
|
504
|
+
height: 800,
|
|
505
|
+
width: 800,
|
|
506
|
+
thumb_uri:
|
|
507
|
+
"tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093",
|
|
508
|
+
thumb_url_list: [
|
|
509
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
510
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
511
|
+
],
|
|
512
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093",
|
|
513
|
+
url_list: [
|
|
514
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
515
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393",
|
|
516
|
+
],
|
|
517
|
+
},
|
|
518
|
+
},
|
|
519
|
+
],
|
|
520
|
+
},
|
|
521
|
+
],
|
|
522
|
+
skus: [
|
|
523
|
+
{
|
|
524
|
+
sku_id: "1730384306561520216",
|
|
525
|
+
sku_sale_props: [
|
|
526
|
+
{
|
|
527
|
+
prop_id: "100000",
|
|
528
|
+
prop_name: "Color",
|
|
529
|
+
prop_value_id: "6926865445131749121",
|
|
530
|
+
prop_value: "Black",
|
|
531
|
+
},
|
|
532
|
+
],
|
|
533
|
+
sale_prop_value_ids: "6926865445131749121",
|
|
534
|
+
stock: 1824,
|
|
535
|
+
purchase_limit: 20,
|
|
536
|
+
price: {
|
|
537
|
+
real_price: {
|
|
538
|
+
price_str: "$2?",
|
|
539
|
+
price_val: "2?",
|
|
540
|
+
currency: "USD",
|
|
541
|
+
original_price: "",
|
|
542
|
+
},
|
|
543
|
+
original_price: "$3?",
|
|
544
|
+
discount: "-47%",
|
|
545
|
+
original_price_value: "3?",
|
|
546
|
+
},
|
|
547
|
+
need_icon: false,
|
|
548
|
+
add_to_cart_button: {
|
|
549
|
+
status: 2,
|
|
550
|
+
},
|
|
551
|
+
warehouse_id: "7348468937296889643",
|
|
552
|
+
quantity_property: {
|
|
553
|
+
default_add_cart_quantity: 1,
|
|
554
|
+
quantity_minus_support_edit: true,
|
|
555
|
+
},
|
|
556
|
+
buy_button: {
|
|
557
|
+
desc: "Buy now",
|
|
558
|
+
default_desc: "Buy now",
|
|
559
|
+
},
|
|
560
|
+
minimum_buy_quantity: 0,
|
|
561
|
+
promotion_limit_quantity: 0,
|
|
562
|
+
deduction_text: "",
|
|
563
|
+
status: 1,
|
|
564
|
+
pdp_button_area_id: "add_disable",
|
|
565
|
+
da_info:
|
|
566
|
+
'{"delivery_flag_sku":"{\\"free_shipping_product_cnt\\":\\"-1\\"}"}',
|
|
567
|
+
},
|
|
568
|
+
],
|
|
569
|
+
product_detail_review: {
|
|
570
|
+
product_rating: 4.3,
|
|
571
|
+
review_count: 595,
|
|
572
|
+
review_items: [
|
|
573
|
+
{
|
|
574
|
+
review: {
|
|
575
|
+
review_id: "7516224145770006315",
|
|
576
|
+
rating: 5,
|
|
577
|
+
display_text:
|
|
578
|
+
"Great product. Good shipping. Exactly as described. Does not nick. Holds charge for a long time. Light weight. Waterproof even used in the shower.",
|
|
579
|
+
review_timestamp: "1750007337100",
|
|
580
|
+
has_origin_text: true,
|
|
581
|
+
display_review_text: [
|
|
582
|
+
{
|
|
583
|
+
text_type: 1,
|
|
584
|
+
plain_text:
|
|
585
|
+
"Great product. Good shipping. Exactly as described. Does not nick. Holds charge for a long time. Light weight. Waterproof even used in the shower.",
|
|
586
|
+
},
|
|
587
|
+
],
|
|
588
|
+
review_timestamp_fmt: "June 15, 2025",
|
|
589
|
+
main_review_title: "",
|
|
590
|
+
},
|
|
591
|
+
sku_id: "1730384306561651288",
|
|
592
|
+
sku_specification: "Item: Blue",
|
|
593
|
+
review_user: {
|
|
594
|
+
name: "thedustinppeterson",
|
|
595
|
+
avatar: {
|
|
596
|
+
url_list: [
|
|
597
|
+
"https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/98315574440f18f07c635207bb216368~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=45b1ac87&x-expires=1754521200&x-signature=Ur3y7f80YCwLVfIEmYaxTbAxuyE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast8",
|
|
598
|
+
"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/98315574440f18f07c635207bb216368~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=da4267ad&x-expires=1754521200&x-signature=aeSEa6RnH9mbbwCFD1JDa3bJsVQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast8",
|
|
599
|
+
"https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/98315574440f18f07c635207bb216368~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=0ec2c591&x-expires=1754521200&x-signature=YVsiflbyT%2Fy%2Bey01NXA%2FsF4Va3s%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast8",
|
|
600
|
+
],
|
|
601
|
+
},
|
|
602
|
+
link: "aweme://user/profile/7019811528040367109?sec_uid=MS4wLjABAAAA6l4bHgDxc3aZPlMYQvuq4K5rnUIIYWPfUjdsFlzKyCVBfKH-gczfRah5vKXjPbrj&from_scene=8",
|
|
603
|
+
},
|
|
604
|
+
is_owner: false,
|
|
605
|
+
is_anonymous: false,
|
|
606
|
+
review_source_type: 0,
|
|
607
|
+
review_source_name: "Purchased on TikTok",
|
|
608
|
+
link: "",
|
|
609
|
+
is_updated: false,
|
|
610
|
+
third_party_popup_title: "",
|
|
611
|
+
third_party_popup_content: "",
|
|
612
|
+
third_party_popup_button_text: "",
|
|
613
|
+
},
|
|
614
|
+
],
|
|
615
|
+
review_count_str: "595",
|
|
616
|
+
review_count_str_v2: "595",
|
|
617
|
+
},
|
|
618
|
+
seller_id: "7496021452055022168",
|
|
619
|
+
},
|
|
620
|
+
shop_info: {
|
|
621
|
+
seller_id: "7496021452055022168",
|
|
622
|
+
sold_count: 50887,
|
|
623
|
+
on_sell_product_count: 14,
|
|
624
|
+
review_count: 4215,
|
|
625
|
+
global_seller_id: "7496021452055022168",
|
|
626
|
+
global_sold_count: "50887",
|
|
627
|
+
followers_count: "1796",
|
|
628
|
+
video_count: "100",
|
|
629
|
+
enable_follow: true,
|
|
630
|
+
shop_name: "Manspot",
|
|
631
|
+
shop_logo: {
|
|
632
|
+
height: 300,
|
|
633
|
+
width: 300,
|
|
634
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc",
|
|
635
|
+
url_list: [
|
|
636
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d",
|
|
637
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d",
|
|
638
|
+
],
|
|
639
|
+
},
|
|
640
|
+
shop_rating: "4.4",
|
|
641
|
+
shop_link:
|
|
642
|
+
"https://www.tiktok.com/shop/store/manspot/7496021452055022168",
|
|
643
|
+
background: {
|
|
644
|
+
is_default: true,
|
|
645
|
+
image: {
|
|
646
|
+
height: 300,
|
|
647
|
+
width: 300,
|
|
648
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc",
|
|
649
|
+
url_list: [
|
|
650
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d",
|
|
651
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d",
|
|
652
|
+
],
|
|
653
|
+
},
|
|
654
|
+
shop_background_type: 3,
|
|
655
|
+
},
|
|
656
|
+
format_sold_count: "50.8K+",
|
|
657
|
+
region: "US",
|
|
658
|
+
display_on_sell_product_count: "14",
|
|
659
|
+
format_global_sold_count: "50.8K+",
|
|
660
|
+
format_followers_count: "1.7K+",
|
|
661
|
+
format_video_count: "100",
|
|
662
|
+
store_sub_score: [
|
|
663
|
+
{
|
|
664
|
+
score: 0.9787,
|
|
665
|
+
type: 1,
|
|
666
|
+
score_percentage: "98",
|
|
667
|
+
high_light_tag: 1,
|
|
668
|
+
platform_rate_type: 0,
|
|
669
|
+
},
|
|
670
|
+
{
|
|
671
|
+
score: 0.9745428973277075,
|
|
672
|
+
type: 2,
|
|
673
|
+
score_percentage: "97",
|
|
674
|
+
high_light_tag: 1,
|
|
675
|
+
platform_rate_type: 1,
|
|
676
|
+
},
|
|
677
|
+
{
|
|
678
|
+
score: 0.8378,
|
|
679
|
+
type: 3,
|
|
680
|
+
score_percentage: "84",
|
|
681
|
+
platform_rate_type: 0,
|
|
682
|
+
},
|
|
683
|
+
],
|
|
684
|
+
worst_rating: "0",
|
|
685
|
+
best_rating: "5",
|
|
686
|
+
creator_name: "Manspot",
|
|
687
|
+
shop_identity_label: {
|
|
688
|
+
label_type: 2,
|
|
689
|
+
identity_label_text: "OFFICIAL SHOP",
|
|
690
|
+
identity_logo_light: {
|
|
691
|
+
height: 144,
|
|
692
|
+
width: 144,
|
|
693
|
+
ratio: 0,
|
|
694
|
+
minetype: "image/png",
|
|
695
|
+
uri: "tos-useast5-i-omjb5zjo8w-tx/e6ee5e25d8a049b39c897d02fe9d3fd4",
|
|
696
|
+
url_list: [
|
|
697
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e6ee5e25d8a049b39c897d02fe9d3fd4~tplv-fhlh96nyum-origin-png.png?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d",
|
|
698
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e6ee5e25d8a049b39c897d02fe9d3fd4~tplv-fhlh96nyum-origin-png.png?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d",
|
|
699
|
+
],
|
|
700
|
+
},
|
|
701
|
+
},
|
|
702
|
+
desc: "Shop Manspot on TikTok Shop! 50.8K+ sold, 1.7K+ followers. 84+% positive feedback. 97+% Ships in 48h, 98+% replies in 24h. Join the trend!",
|
|
703
|
+
},
|
|
704
|
+
shop_performance: [
|
|
705
|
+
{
|
|
706
|
+
score_percentile: 98,
|
|
707
|
+
type: 1,
|
|
708
|
+
},
|
|
709
|
+
{
|
|
710
|
+
score_percentile: 97,
|
|
711
|
+
type: 2,
|
|
712
|
+
},
|
|
713
|
+
{
|
|
714
|
+
score_percentile: 84,
|
|
715
|
+
type: 3,
|
|
716
|
+
},
|
|
717
|
+
{
|
|
718
|
+
score_percentile: 94,
|
|
719
|
+
type: 10,
|
|
720
|
+
},
|
|
721
|
+
],
|
|
722
|
+
related_videos: [
|
|
723
|
+
{
|
|
724
|
+
item_id: "7527142083258305822",
|
|
725
|
+
height: 1920,
|
|
726
|
+
width: 1080,
|
|
727
|
+
duration: 57900,
|
|
728
|
+
author_id: "6680168318781539334",
|
|
729
|
+
play_count: 324944,
|
|
730
|
+
like_count: 1812,
|
|
731
|
+
upload_time: "1752549352",
|
|
732
|
+
expiration_time: "1754373525",
|
|
733
|
+
title:
|
|
734
|
+
"#clippers #manspot #balltrimmerformen #cleanshave #intimatetrimmer ",
|
|
735
|
+
cover_image_url:
|
|
736
|
+
"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8EuB9REQEAfeQLrDo7AjEqsVBFWXjdDckKa4u~tplv-tiktokx-360p.jpeg?dr=9616&refresh_token=1766d771&x-expires=1754434800&x-signature=lRWsCgvnwEp6UQqLhsH0PgRn88M%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8&s=TTEC_PDP_WEB&ftpl=1",
|
|
737
|
+
content_url:
|
|
738
|
+
"https://v16m-default.tiktokcdn-us.com/dd4ea5ea67c5f3bff2da44a43344e9d0/68919d95/video/tos/useast8/tos-useast8-ve-0068c001-tx2/o8IDodguOBacEBEqW4WEKsUAEjVfrXQQjAfFRj/?a=0&bti=MzV2KXVmcnZmd0BqOjo2QDI6bWJsK2IrYnFgIzE0M2A%3D&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2308&bt=1154&cs=0&ds=6&ft=LlnQ7z4HhWH6Bbg7.FLo0PD1&mime_type=video_mp4&qs=0&rc=ZzM0PDtnaWQ8NTVpZmk2O0BpM2U2bnE5cjl2NDMzaTczNEA2YmMtLi00XmIxYzE1YGNfYSNlYGBeMmRrX25hLS1kMTJzcw%3D%3D&vvpl=1&l=202508042357476500B0C762E3A801E8F3&btag=e00088000",
|
|
739
|
+
author_name: "❤️ Brittney ❤️",
|
|
740
|
+
author_avatar_url:
|
|
741
|
+
"https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/9fbaf570003150d9888e44ed5b03b03c~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=1d0acc0f&x-expires=1754434800&x-signature=BqNkRAZzwhzBPbXPm%2FzMqw5FKzQ%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
|
|
742
|
+
bc_ad_label_text: "Commission paid",
|
|
743
|
+
url: "https://www.tiktok.com/@6680168318781539334/video/7527142083258305822",
|
|
744
|
+
author_url: "https://www.tiktok.com/@6680168318781539334",
|
|
745
|
+
},
|
|
746
|
+
],
|
|
747
|
+
},
|
|
748
|
+
},
|
|
749
|
+
{
|
|
750
|
+
name: "Product Reviews",
|
|
751
|
+
method: "GET",
|
|
752
|
+
description: "Get a product's reviews",
|
|
753
|
+
fullDescription: "Fetches customer reviews for a TikTok Shop product by URL or product_id. Returns `product_reviews`, an array of review objects each with `rating`, `display_text`, `review_timestamp_fmt`, `review_user` (name, avatar), and `sku_specification` (variant purchased); also returns `total_reviews` count and `rating_distribution`. Paginate with `page`.",
|
|
754
|
+
path: "/v1/tiktok/shop/product/reviews",
|
|
755
|
+
params: [
|
|
756
|
+
{
|
|
757
|
+
name: "url",
|
|
758
|
+
description: "The URL of the product (required if product_id is not provided)",
|
|
759
|
+
type: "string",
|
|
760
|
+
required: false,
|
|
761
|
+
placeholder: "https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516",
|
|
762
|
+
},
|
|
763
|
+
{
|
|
764
|
+
name: "product_id",
|
|
765
|
+
description: "The ID of the product (required if url is not provided)",
|
|
766
|
+
type: "string",
|
|
767
|
+
required: false,
|
|
768
|
+
placeholder: "1731578642912612516",
|
|
769
|
+
},
|
|
770
|
+
{
|
|
771
|
+
name: "page",
|
|
772
|
+
description: "The page number of the reviews",
|
|
773
|
+
type: "number",
|
|
774
|
+
required: false,
|
|
775
|
+
placeholder: "1",
|
|
776
|
+
},
|
|
777
|
+
],
|
|
778
|
+
sampleResponse: {
|
|
779
|
+
"success": true,
|
|
780
|
+
"credits_remaining": 33701168,
|
|
781
|
+
"has_more": true,
|
|
782
|
+
"total_reviews": "5967",
|
|
783
|
+
"product_reviews": [
|
|
784
|
+
{
|
|
785
|
+
"review_id": "7449648277383333678",
|
|
786
|
+
"product_id": "1729412793274503379",
|
|
787
|
+
"sku_id": "1729480195115684051",
|
|
788
|
+
"reviewer_id": "7118466497416561707",
|
|
789
|
+
"review_rating": 4,
|
|
790
|
+
"review_time": "1734506431877",
|
|
791
|
+
"is_verified_purchase": true,
|
|
792
|
+
"is_incentivized_review": false,
|
|
793
|
+
"product_name": "OLOV Beard/Hair Shaver for Men - All-in-One Mens Grooming Kit with Trimmer for Beard, Nose, face, Cordless Hair Clippers Electric Razor, Black Comfort",
|
|
794
|
+
"reviewer_name": "W**n",
|
|
795
|
+
"reviewer_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8a5ef54ee47fd27614d4d576879cd630~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=6e5d3b6e&x-expires=1771009200&x-signature=1HE0d6u3ZL2NY%2FWG88r8zUltKS4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5",
|
|
796
|
+
"review_text": "Product arrived intact no issues. Love all the attachments. Cuts very very well. Charges quick and efficiently. The only reason I gave a 4 was listening to the reels it’s supposed to be nip free. That was a lie, I nipped my balls and that’s not fun. I took pics other than that great product.",
|
|
797
|
+
"display_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9460bee85df472a8455f33df693cb8d~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
798
|
+
"review_images": [
|
|
799
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9460bee85df472a8455f33df693cb8d~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
800
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/86ca79beec2744f2b24944320dc54183~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
801
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c23968b8ce354373811d9f583798d7dc~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
802
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/114d32cfff304a16b77c42de6b38bbc8~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
803
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/f75adcbf5f3a48df966d5c4b709b1b1f~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"
|
|
804
|
+
],
|
|
805
|
+
"sku_specification": "Black",
|
|
806
|
+
"review_country": "US"
|
|
807
|
+
},
|
|
808
|
+
{
|
|
809
|
+
"review_id": "7449933365429487403",
|
|
810
|
+
"product_id": "1729412793274503379",
|
|
811
|
+
"sku_id": "1729480195115684051",
|
|
812
|
+
"reviewer_id": "7069790017161298986",
|
|
813
|
+
"review_rating": 5,
|
|
814
|
+
"review_time": "1734572786348",
|
|
815
|
+
"is_verified_purchase": true,
|
|
816
|
+
"is_incentivized_review": false,
|
|
817
|
+
"product_name": "OLOV Beard/Hair Shaver for Men - All-in-One Mens Grooming Kit with Trimmer for Beard, Nose, face, Cordless Hair Clippers Electric Razor, Black Comfort",
|
|
818
|
+
"reviewer_name": "N**n",
|
|
819
|
+
"reviewer_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/455d12c1591e41a482bfd31866fc3df5~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=1859a901&x-expires=1771009200&x-signature=R7rbh3FBfRaj14VxWhPdQ2J1v10%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5",
|
|
820
|
+
"review_text": "Amazing product very high quality and looks very good One problem is my first time using it below the belt I nicked my self most likely bc I never used it B4 n wasn't careful other than that amazing product would recommend received all items shown all work good imo worth the buy (No I'm not sum ai)",
|
|
821
|
+
"display_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b528a2f1272f4b24af497ae44a44f441~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
822
|
+
"review_images": [
|
|
823
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b528a2f1272f4b24af497ae44a44f441~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
824
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/83443ff950ed42eaab0c3ede4736445b~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
825
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/71d4abb17dcb4c5aa59092db383a87d8~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"
|
|
826
|
+
],
|
|
827
|
+
"sku_specification": "Black",
|
|
828
|
+
"review_country": "US"
|
|
829
|
+
},
|
|
830
|
+
{
|
|
831
|
+
"review_id": "7535169519766095629",
|
|
832
|
+
"product_id": "1729412793274503379",
|
|
833
|
+
"sku_id": "1729553962947023059",
|
|
834
|
+
"review_rating": 5,
|
|
835
|
+
"review_time": "1754418389294",
|
|
836
|
+
"is_verified_purchase": true,
|
|
837
|
+
"is_incentivized_review": false,
|
|
838
|
+
"product_name": "OLOV Beard/Hair Shaver for Men - All-in-One Mens Grooming Kit with Trimmer for Beard, Nose, face, Cordless Hair Clippers Electric Razor, Black Comfort",
|
|
839
|
+
"reviewer_name": "b**n",
|
|
840
|
+
"review_text": "its a good home kit for men, it got all necessary needs and for a good price, ( recommended🧼 )",
|
|
841
|
+
"display_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2ee9ed056bf94dbc8951eb6db0d6a2a6~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
842
|
+
"review_images": [
|
|
843
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2ee9ed056bf94dbc8951eb6db0d6a2a6~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
844
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/7c419f87e4804f5c8721db3c9833e264~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
845
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2809968e7cb247ffb5f01ad3e4de5c9f~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
846
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/51632cbc1433444788fb85beaa6fc019~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"
|
|
847
|
+
],
|
|
848
|
+
"sku_specification": "Gold",
|
|
849
|
+
"review_country": "US"
|
|
850
|
+
},
|
|
851
|
+
{
|
|
852
|
+
"review_id": "7514713260093114154",
|
|
853
|
+
"product_id": "1729412793274503379",
|
|
854
|
+
"sku_id": "1729480195115684051",
|
|
855
|
+
"review_rating": 1,
|
|
856
|
+
"review_time": "1749655549764",
|
|
857
|
+
"is_verified_purchase": true,
|
|
858
|
+
"is_incentivized_review": false,
|
|
859
|
+
"product_name": "OLOV Beard/Hair Shaver for Men - All-in-One Mens Grooming Kit with Trimmer for Beard, Nose, face, Cordless Hair Clippers Electric Razor, Black Comfort",
|
|
860
|
+
"reviewer_name": "D**🃏",
|
|
861
|
+
"review_text": "These are not actual size hair clippers... They are smaller trimmers... Cheap product... Clipper head was broken, out of box... there was some tiny pieces of hair on them as if they were used... the lil oil bottle had a hole in it, all the oil drained out & got on everything. Would not recommend...",
|
|
862
|
+
"display_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/24fec74a43ac4280b728a9834c40d8b2~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
863
|
+
"review_images": [
|
|
864
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/24fec74a43ac4280b728a9834c40d8b2~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
865
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/51e75c89e22e4f298f01a22a1b923c5f~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
866
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/fac8e67cb1c54af0ae09a15fa15252d2~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
867
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/4cdc642892f647c4aa53616259c76b2f~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"
|
|
868
|
+
],
|
|
869
|
+
"sku_specification": "Black",
|
|
870
|
+
"review_country": "US"
|
|
871
|
+
},
|
|
872
|
+
{
|
|
873
|
+
"review_id": "7488447318287697707",
|
|
874
|
+
"product_id": "1729412793274503379",
|
|
875
|
+
"sku_id": "1729480195115684051",
|
|
876
|
+
"reviewer_id": "7402437626568377386",
|
|
877
|
+
"review_rating": 5,
|
|
878
|
+
"review_time": "1743540026729",
|
|
879
|
+
"is_verified_purchase": true,
|
|
880
|
+
"is_incentivized_review": false,
|
|
881
|
+
"product_name": "OLOV Beard/Hair Shaver for Men - All-in-One Mens Grooming Kit with Trimmer for Beard, Nose, face, Cordless Hair Clippers Electric Razor, Black Comfort",
|
|
882
|
+
"reviewer_name": "H**n H**y",
|
|
883
|
+
"reviewer_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/17bfcaa335206f3cd543c65d5b1c299f~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=b404adc3&x-expires=1771009200&x-signature=J7gh%2F0ae7q52rAIPPXd22DojumA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5",
|
|
884
|
+
"review_text": "Arrived sooner than I thought! Very excited to use this, not damaged at all, perfectly boxed, everything is in the box, it is amazing",
|
|
885
|
+
"display_image_url": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/58bddee9a90b4f07b08199d211213b0a~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
886
|
+
"review_images": [
|
|
887
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/58bddee9a90b4f07b08199d211213b0a~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
888
|
+
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/4a00f2191d26451b997a1c5b1ceae1e3~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
889
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/f4547fe0014f41c08fad7e4317e9029a~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
|
|
890
|
+
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/140196376e2e4928bb6529c8731b4ac1~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"
|
|
891
|
+
],
|
|
892
|
+
"sku_specification": "Black",
|
|
893
|
+
"review_country": "US"
|
|
894
|
+
}
|
|
895
|
+
],
|
|
896
|
+
"review_ratings": {
|
|
897
|
+
"review_count": "5967",
|
|
898
|
+
"overall_score": 4.4,
|
|
899
|
+
"rating_result": {
|
|
900
|
+
"1": "475",
|
|
901
|
+
"2": "161",
|
|
902
|
+
"3": "289",
|
|
903
|
+
"4": "740",
|
|
904
|
+
"5": "4302"
|
|
905
|
+
}
|
|
906
|
+
}
|
|
907
|
+
}
|
|
908
|
+
},
|
|
909
|
+
// {
|
|
910
|
+
// name: "User Showcase",
|
|
911
|
+
// method: "GET",
|
|
912
|
+
// description: "Gets public user's showcase products",
|
|
913
|
+
// fullDescription: "Fetches products featured in a TikTok user's public showcase — the products a creator promotes on their profile. Returns an array of product objects each with title, price, images, and shop details.",
|
|
914
|
+
// path: "/v1/tiktok/user/showcase",
|
|
915
|
+
// params: [
|
|
916
|
+
// {
|
|
917
|
+
// name: "handle",
|
|
918
|
+
// type: "string",
|
|
919
|
+
// description: "The handle of the user",
|
|
920
|
+
// required: true,
|
|
921
|
+
// placeholder: "mrtiktokreviews",
|
|
922
|
+
// },
|
|
923
|
+
// {
|
|
924
|
+
// name: "region",
|
|
925
|
+
// type: "string",
|
|
926
|
+
// description: "Region to put the proxy in",
|
|
927
|
+
// required: false,
|
|
928
|
+
// placeholder: "US",
|
|
929
|
+
// },
|
|
930
|
+
// {
|
|
931
|
+
// name: "cursor",
|
|
932
|
+
// type: "string",
|
|
933
|
+
// description: "The cursor to the next page of products",
|
|
934
|
+
// required: false,
|
|
935
|
+
// placeholder: "21",
|
|
936
|
+
// }
|
|
937
|
+
// ],
|
|
938
|
+
// sampleResponse: {
|
|
939
|
+
// "success": true,
|
|
940
|
+
// "credits_remaining": 49999721933,
|
|
941
|
+
// "products": [
|
|
942
|
+
// {
|
|
943
|
+
// "product_id": "1732210666230419545",
|
|
944
|
+
// "title": "Be Bodywise Hair Growth Roll-On Serum | New Year New You Edition | 3% Rosemary, 3% Redensyl, 2% AnaGain | Precision Scalp Applicator | Paraben/Sulphate-Free | Non-Oily | DHT-Care Botanicals | 50ml",
|
|
945
|
+
// "image": {
|
|
946
|
+
// "height": 500,
|
|
947
|
+
// "width": 500,
|
|
948
|
+
// "uri": "tos-useast5-i-omjb5zjo8w-tx/b4088e56fc3140799ab2e52674339db4",
|
|
949
|
+
// "url_list": [
|
|
950
|
+
// "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b4088e56fc3140799ab2e52674339db4~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398",
|
|
951
|
+
// "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b4088e56fc3140799ab2e52674339db4~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398"
|
|
952
|
+
// ]
|
|
953
|
+
// },
|
|
954
|
+
// "product_price_info": {
|
|
955
|
+
// "sku_id": "1732210669134516313",
|
|
956
|
+
// "symbol_position": 1,
|
|
957
|
+
// "show_currency_space": false,
|
|
958
|
+
// "currency_show_mode": 1,
|
|
959
|
+
// "currency_name": "USD",
|
|
960
|
+
// "currency_symbol": "$",
|
|
961
|
+
// "sale_price_decimal": "46.58",
|
|
962
|
+
// "origin_price_decimal": "53",
|
|
963
|
+
// "sale_price_format": "46.58",
|
|
964
|
+
// "origin_price_format": "53.00",
|
|
965
|
+
// "discount_format": "12%",
|
|
966
|
+
// "discount_decimal": "0.12",
|
|
967
|
+
// "single_product_price_format": "46.58",
|
|
968
|
+
// "single_product_price_decimal": "46.58",
|
|
969
|
+
// "sale_price_integer_part_format": "46",
|
|
970
|
+
// "sale_price_decimal_part_format": "58",
|
|
971
|
+
// "decimal_point_symbol": ".",
|
|
972
|
+
// "promotion_deduction_details": {
|
|
973
|
+
// "seller_subtotal_deduction": "6.42",
|
|
974
|
+
// "seller_subtotal_deduction_decimal": "6.42"
|
|
975
|
+
// }
|
|
976
|
+
// },
|
|
977
|
+
// "rate_info": {
|
|
978
|
+
// "score": 4.5,
|
|
979
|
+
// "review_count": 326
|
|
980
|
+
// },
|
|
981
|
+
// "sold_info": {
|
|
982
|
+
// "sold_count": 5457
|
|
983
|
+
// },
|
|
984
|
+
// "seller_info": {
|
|
985
|
+
// "seller_id": "7495572938346760281"
|
|
986
|
+
// },
|
|
987
|
+
// "seo_url": {
|
|
988
|
+
// "updated_at": null,
|
|
989
|
+
// "canonical_url": "https://www.tiktok.com/shop/pdp/1732210666230419545",
|
|
990
|
+
// "slug": "be-bodywise-hair-growth-roll-on-serum-new-year-new-you-edition-3-rosemary-3-redensyl-2-anagain-precision-scalp-applicator-paraben-sulphate-free-non-oily-dht-care-botanicals-50ml",
|
|
991
|
+
// "type": 2,
|
|
992
|
+
// "version": 2
|
|
993
|
+
// }
|
|
994
|
+
// },
|
|
995
|
+
// {
|
|
996
|
+
// "product_id": "1729499864890250680",
|
|
997
|
+
// "title": "Nello Superbalance Hormonal Support Drink Mix, 20 Travel Packets, SRI-81 Shatavari, Myo-Inositol, Rhodiola Rosea, Vitamin C, Magnesium, Theobromine, Vitamin B6/C",
|
|
998
|
+
// "image": {
|
|
999
|
+
// "height": 500,
|
|
1000
|
+
// "width": 500,
|
|
1001
|
+
// "uri": "tos-useast8-i-rt0ujvrtvp-tx2/5f8ea7d0fc53439599d7dbc7052f9bcf",
|
|
1002
|
+
// "url_list": [
|
|
1003
|
+
// "https://p16-oec-general-useast8.ttcdn-us.com/tos-useast8-i-rt0ujvrtvp-tx2/5f8ea7d0fc53439599d7dbc7052f9bcf~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398",
|
|
1004
|
+
// "https://p19-oec-general-useast8.ttcdn-us.com/tos-useast8-i-rt0ujvrtvp-tx2/5f8ea7d0fc53439599d7dbc7052f9bcf~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398"
|
|
1005
|
+
// ]
|
|
1006
|
+
// },
|
|
1007
|
+
// "product_price_info": {
|
|
1008
|
+
// "sku_id": "1729499867243648440",
|
|
1009
|
+
// "symbol_position": 1,
|
|
1010
|
+
// "show_currency_space": false,
|
|
1011
|
+
// "currency_show_mode": 1,
|
|
1012
|
+
// "currency_name": "USD",
|
|
1013
|
+
// "currency_symbol": "$",
|
|
1014
|
+
// "sale_price_decimal": "31.99",
|
|
1015
|
+
// "origin_price_decimal": "59.99",
|
|
1016
|
+
// "sale_price_format": "31.99",
|
|
1017
|
+
// "origin_price_format": "59.99",
|
|
1018
|
+
// "discount_format": "47%",
|
|
1019
|
+
// "discount_decimal": "0.47",
|
|
1020
|
+
// "single_product_price_format": "31.99",
|
|
1021
|
+
// "single_product_price_decimal": "31.99",
|
|
1022
|
+
// "sale_price_integer_part_format": "31",
|
|
1023
|
+
// "sale_price_decimal_part_format": "99",
|
|
1024
|
+
// "decimal_point_symbol": ".",
|
|
1025
|
+
// "promotion_deduction_details": {
|
|
1026
|
+
// "seller_subtotal_deduction": "28.00",
|
|
1027
|
+
// "seller_subtotal_deduction_decimal": "28.00"
|
|
1028
|
+
// }
|
|
1029
|
+
// },
|
|
1030
|
+
// "rate_info": {
|
|
1031
|
+
// "score": 4.6,
|
|
1032
|
+
// "review_count": 54
|
|
1033
|
+
// },
|
|
1034
|
+
// "sold_info": {
|
|
1035
|
+
// "sold_count": 6808
|
|
1036
|
+
// },
|
|
1037
|
+
// "seller_info": {
|
|
1038
|
+
// "seller_id": "7495315412032719288"
|
|
1039
|
+
// },
|
|
1040
|
+
// "seo_url": {
|
|
1041
|
+
// "updated_at": null,
|
|
1042
|
+
// "canonical_url": "https://www.tiktok.com/shop/pdp/1729499864890250680",
|
|
1043
|
+
// "slug": "nello-superbalance-hormonal-support-drink-mix-20-travel-packets-sri-81-shatavari-myo-inositol-rhodiola-rosea-vitamin-c-magnesium-theobromine-vitamin-b6-c",
|
|
1044
|
+
// "type": 2,
|
|
1045
|
+
// "version": 2
|
|
1046
|
+
// }
|
|
1047
|
+
// }
|
|
1048
|
+
// ],
|
|
1049
|
+
// "cursor": "41"
|
|
1050
|
+
// }
|
|
1051
|
+
// }
|
|
1052
|
+
],
|
|
1053
|
+
};
|