TikTok Shop
Search / Products / Showcase
per_call
Search TikTok Shop by keyword or category for products with price, rating, sold count and shop reference, and pull the product showcase a creator lists on their profile. Built for social-commerce and affiliate-opportunity research.
What you get
Each call returns up to 40 products, plus a cursor for the next 40.
Endpoint
GET /v1/tiktok-shop/search-products-showcase
Price
$1.50
per 1,000 calls · $0.0015 per call
Cost per call
1 credit
Failed calls never charged
Parameters
target
required
stringThe TikTok Shop handle, URL or identifier to resolve.
limit
optional
integerMaximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.
cursor
optional
stringPagination cursor returned by a previous response.
fresh
optional
enumBypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.
One of: true, 1, false, 0
Example request
Live call. Successful calls are charged; failed and empty results are not.
curl
curl "https://fastfetchz.com/v1/tiktok-shop/search-products-showcase?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"Example response
200 application/json
{
"success": true,
"service": {
"platform": "TikTok Shop",
"name": "Search / Products / Showcase",
"slug": "search-products-showcase"
},
"credits_charged": 1,
"credits_remaining": 99,
"latency_ms": 214,
"data": {
"query": "headphones",
"total_products": 43,
"products": [
{
"product_id": "1730798863344243044",
"title": "WENTRONIC Y01 Over-Ear Bluetooth Headset ANC Hi-Fi 48H Playtime",
"product_description": null,
"ship_from": null,
"trust_label": null,
"product_label": "promotion_label_4-7681558687380129549,promotion_label_6-7675943703738926862,warehouse_label_8-8",
"product_label_info": [
{
"label_type": 8,
"text": "Free shipping"
}
],
"search_meta": {
"search_result_id": "1730798863344243044",
"search_id": "2026090820052328F244E0F89CC326AE62",
"entrance_form": "search_pure_goods_card"
},
"image": {
"height": 400,
"width": 400,
"uri": "tos-useast5-i-omjb5zjo8w-tx/55dadcf0ffc94b5cab22b3051a1c4b86",
"url_list": [
"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/55dadcf0ffc94b5cab22b3051a1c4b86~tplv-fhlh96nyum-crop-webp:400:400.webp?dr=12190&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=useast5&from=1737278001",
"https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/55dadcf0ffc94b5cab22b3051a1c4b86~tplv-fhlh96nyum-crop-webp:400:400.webp?dr=12190&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=useast5&from=1737278001"
]
},
"video": null,
"category_breadcrumb": null,
"product_price_info": {
"sale_price_decimal": "36.76",
"sale_price_format": "36.76",
"single_product_price_format": "36.76",
"single_product_price_decimal": "36.76",
"sale_price_integer_part_format": "36",
"sale_price_decimal_part_format": "76",
"decimal_point_symbol": ".",
"symbol_position": 1,
"show_currency_space": false,
"currency_show_mode": 1,
"currency_name": "USD",
"currency_symbol": "$",
"origin_price_decimal": "99.00",
"origin_price_format": "99.00",
"discount_decimal": "0.63",
"discount_format": "63%",
"reduce_price_format": "Saving $62.24",
"promotion_deduction_details": {
"seller_subtotal_deduction": "62.24",
"seller_subtotal_deduction_decimal": "62"
}
},
"rate_info": {
"score": 4.3,
"review_count": null
},
"sold_info": {
"sold_count": 30492
},
"seller_info": {
"seller_id": "7496106741758658916",
"shop_name": "WentronicDirect",
"shop_logo": null
},
"seo_url": {
"updated_at": "1788897928431",
"canonical_url": "https://www.tiktok.com/shop/pdp/1730798863344243044",
"slug": "wentronic-y01-over-ear-bluetooth-headset-anc-hi-fi-48h-playtime",
"type": 2,
"version": 2
}
},
{
"product_id": "1732124744671400072",
"title": "soundcore V20i by Anker Open-Ear Headphones, Adjustable Ear Hooks, Ultra-Comfort, Snug Fit, Powerful Sound, Clear Calls, IP55, 36H Playtime, Bluetooth 5.4 Wireless Earbuds, Multipoint Connection #tiktokshopsummersale",
"product_description": null,
"ship_from": null,
"trust_label": "blue_v",
"product_label": "warehouse_label_8-8",
"product_label_info": [
{
"label_type": 8,
"text": "Free shipping"
}
],
"search_meta": {
"search_result_id": "7650551413952580877",
"search_id": "2026090820052328F244E0F89CC326AE62",
"entrance_form": "search_video_goods_card"
},
"image": {
"height": 600,
"width": 450,
"uri": "tos-maliva-i-o3syd03w52-us/29f180fac6aa2261a90934be789e5ab8",
"url_list": [
"https://p16-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/29f180fac6aa2261a90934be789e5ab8~tplv-fhlh96nyum-crop-webp:450:600.webp?dr=12190&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=useast5&from=1737278001",
"https://p19-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/29f180fac6aa2261a90934be789e5ab8~tplv-fhlh96nyum-crop-webp:450:600.webp?dr=12190&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=useast5&from=1737278001"
]
},
"video": {
"url_list": [
"https://v16m.tiktokcdn-us.com/450e667a2251ec321d31531bd5178468/6aa0bf00/video/tos/useast5/tos-useast5-ve-0068c001-tx/oUFGRDWeIAkQ6cgI9HcE3jeIwQJjAQFAUYCOsf/?a=1233&bti=NEBzbmRidWZrdWgxaHdmKTc6OWYucCNgbWFeK2BecGBxOmQ0NDA6&&bt=1246&ft=WgSBMNTYVUywUytrzLnq2Ef5Sa0Ev1PXtNiEspxyqF_4&mime_type=video_mp4&rc=Omg4NWRnZTM0NjpoOWc7NkBpM2g0a3g5cjc2OzMzZzczNEAtXzIuYV8tNWIxNDBfLzE1YSNfMGxyMmQ0Y2phLS1kMS9zcw%3D%3…",
"https://v19.tiktokcdn-us.com/2c02e8af7484feada2b3f4d7a8a8b71f/6aa0bf00/video/tos/useast5/tos-useast5-ve-0068c001-tx/oUFGRDWeIAkQ6cgI9HcE3jeIwQJjAQFAUYCOsf/?a=1233&bti=NEBzbmRidWZrdWgxaHdmKTc6OWYucCNgbWFeK2BecGBxOmQ0NDA6&&bt=1246&ft=WgSBMNTYVUywUytrzLnq2Ef5Sa0Ev1PXtNiEspxyqF_4&mime_type=video_mp4&rc=Omg4NWRnZTM0NjpoOWc7NkBpM2g0a3g5cjc2OzMzZzczNEAtXzIuYV8tNWIxNDBfLzE1YSNfMGxyMmQ0Y2phLS1kMS9zcw%3D%3D…"
],
"img_urls": [],
"aweme_id": "7650551413952580877",
"desc": "Soundcore V20i open-ear headphones deliver powerful sound, all-day comfort, customizable EQ settings, and LED light effects in one lightweight design. Perfect for workouts, commuting, and daily use with Bluetooth 5.4, clear AI-powered calls, and up to 36 hours of battery life.a #ancearbuds #bluetoothearbuds #gamingearbuds #soundcore #pvroofer ",
"create_time": 1781282846,
"share_url": "https://www.tiktok.com/@watchdot6/video/7650551413952580877?_r=1&u_code=f0fi8hc707g495&preview_pb=0&sharer_language=en&_d=f0gla3f0l12h58&ec_shared_reflux_dynamic_params=%7B%22device_id%22%3A%227576678639576548878%22%2C%22placeholder_material_id%22%3A%227650551413952580877%22%2C%22placeholder_origin_cover%22%3A%22https%253A%252F%252Fp19-common-sign.tiktokcdn-us.com%252Ftos-useast5-p-0068-tx%252Fo0I…",
"duration_ms": 27121,
"author": {
"uid": "7291325377864533038",
"nickname": "Optusstore LLC",
"unique_id": "watchdot6",
"sec_uid": "MS4wLjABAAAAtwuHT5rrTRtwrsvZOTg4IW-s1a3Lfj0x1ZfsuXsWFjmaib9VmGXgjZjJ_yBIDKaV",
"follower_count": 31380
},
"music": {
"id": 7650551527890849000,
"id_str": "7650551527890848526",
"title": "original sound - watchdot6",
"author": "Optusstore LLC"
},
"statistics": {
"comment_count": 0,
"digg_count": 4,
"play_count": 2781,
"share_count": 5,
"collect_count": 1
},
"cha_list": [
{
"cid": "7033477394379833349",
"cha_name": "ancearbuds",
"desc": ""
}
]
},
"category_breadcrumb": [
{
"category_id": 601739,
"category_name": "Phones & Electronics",
"level": 1
},
{
"category_id": 909320,
"category_name": "Audio & Video",
"level": 2
}
],
"product_price_info": {
"sale_price_decimal": "26.99",
"sale_price_format": "26.99",
"single_product_price_format": "26.99",
"single_product_price_decimal": "26.99",
"sale_price_integer_part_format": "26",
"sale_price_decimal_part_format": "99",
"decimal_point_symbol": ".",
"symbol_position": 1,
"show_currency_space": false,
"currency_show_mode": 1,
"currency_name": "USD",
"currency_symbol": "$",
"origin_price_decimal": "49.99",
"origin_price_format": "49.99",
"discount_decimal": "0.46",
"discount_format": "46%",
"reduce_price_format": "Saving $23.00",
"promotion_deduction_details": {
"seller_subtotal_deduction": "23.00",
"seller_subtotal_deduction_decimal": "23"
}
},
"rate_info": {
"score": 4.5,
"review_count": null
},
"sold_info": {
"sold_count": 293
},
"seller_info": {
"seller_id": "7495298225862576264",
"shop_name": "Soundcore.US",
"shop_logo": null
},
"seo_url": {
"updated_at": "1788897928433",
"canonical_url": "https://www.tiktok.com/shop/pdp/1732124744671400072",
"slug": "soundcore-v20i-by-anker-open-ear-headphones-adjustable-ear-hooks-ultra-comfort-snug-fit-powerful-sound-clear-calls-ip55-36h-playtime-bluetooth-5-4-wireless-earbuds-multipoint-connection-tiktokshopsummersale",
"type": 2,
"version": 2
}
}
]
}
}Getting more results
Each response includes a cursor. Pass it back as cursor to fetch the next 40 products. Repeat until no cursor is returned.
two calls
# Call 1 — first 40 products
curl "https://fastfetchz.com/v1/tiktok-shop/search-products-showcase?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"
# -> { "data": { ... }, "cursor": "eyJwYWdlIjoyfQ" }
# Call 2 — next 40 products
curl "https://fastfetchz.com/v1/tiktok-shop/search-products-showcase?target=nasa&cursor=eyJwYWdlIjoyfQ" \
-H "X-API-Key: $FASTFETCHZ_KEY"Limits
- Maximum per call: 40 products.
- Minimum per call: 1 product — a target with less data returns fewer products, and an empty result is still a successful call.
- Each call fetches a full page of up to 40 and costs the same either way. Pass limit to receive fewer than that in the response.
- Larger jobs are paginated with a cursor; there is no cap on how many pages you fetch.
What this costs in practice
400,000 products = 10,000 calls × 1 credits per call = 10,000 credits = $0.00
Priced at the Custom pack rate: 1,000,000 credits for $0.00.
Open in the pricing calculatorError codes
StatusCodeMeaning
401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.