tiktok_shop_search template is built to obtain search result pages from TikTok Shop.
Useful Links
- Real-time and Asynchronous integration methods are available for this template.
- Batch requests are also supported.
Input Parameters
Request parameters available for the TikTok Shop Search template:| Parameter | Type | Required | Description |
|---|---|---|---|
target | string | ✅ | Target type must be set to tiktok_shop_search. |
query | string | ✅ | Search query. |
country | string | Set this parameter to gb when you want to retrieve results specific to the United Kingdom. | |
headless | string | html value enables JavaScript rendering. Read more.png value enables screenshot response. Read more. | |
device_type | string | Specify device type and browser. Read more. | |
xhr | boolean | Set to true to retrieve a list of XHR and fetch requests. Read more.Default value is false. | |
markdown | boolean | Set to true to receive a Markdown response. Read more.Default value is false. |
Request Examples
# update 'TOKEN VALUE' with your API KEY
curl --request 'POST' \
--url 'https://data.decodo.com/v1/scrape' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN VALUE' \
--header 'Content-Type: application/json' \
--data '
{
"target": "tiktok_shop_search",
"query": "hoodie"
}
'
const scrape = async() => {
const response = await fetch("https://data.decodo.com/v1/scrape", {
method: "POST",
body: JSON.stringify({
"target": "tiktok_shop_search",
"query": "hoodie"
}),
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer TOKEN VALUE" // update with your API KEY
},
}).catch(error => console.log(error));
console.log(await response.json())
}
scrape()
import requests
url = "https://data.decodo.com/v1/scrape"
payload = {
"target": "tiktok_shop_search",
"query": "hoodie"
}
headers = {
"accept": "application/json",
"content-type": "application/json",
"authorization": "Bearer TOKEN VALUE" # update with your API KEY
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
Output
Response Example
{
"results": [
{
"content":"<!doctype html><html><head><script src=\"https://lf16-tiktok-web.tiktokcdn-us.com/obj/tiktok-web-tx/tiktok_privacy_protection_framework/loader/2.0.0.260/index.js\" crossorigin=\"anonymous\" async data-business=\"i18n_ecom_fe.growth.brandy_builder\" data-sw=\"/sw.js\" data-env=\"production\" data-region=\"us-ttp\" data-sw_version=\"1.0.0.89,2.0.0.4\"></script><script id=\"slardar-config\" type=\"application/json\">{\n \"disableInit\": \"true\",\n \"slardarClient\": \"Slardar\",...",
"headers": {
"date": "Wed, 12 Nov 2025 12:06:07 GMT",
"vary": "User-Agent",
"pragma": "no-cache",
"server": "nginx",
"expires": "Wed, 12 Nov 2025 12:06:07 GMT",
"x-cache": "TCP_MISS from a23-213-246-142.deploy.akamaitechnologies.com (AkamaiGHost/22.3.1-beec7c8e6b19d04c9cf512962152fd16) (-)",
"x-tt-logid": "20251112120606D7A9167A786571027D4C",
"content-type": "text/html; charset=UTF-8",
"x-gw-dst-psm": "i18n_ecom_fe.growth.brandy_builder",
"x-powered-by": "Goofy Node",
"cache-control": "max-age=0, no-cache, no-store",
"server-timing": "cdn-cache; desc=MISS, edge; dur=1, origin; dur=1529",
"x-tt-trace-id": "00-251112120606D7A9167A786571027D4C-483D26A74ABBB572-00",
"x-tt-trace-tag": "id=16;cdn-cache=miss;type=dyn",
"x-tt-trace-host": "01f8fdb41ffe88624f59ed9d9eb541e2af30e24b7ca1a5c2d403da32472d42974d6ac9594474d955a7ef0910cffabe8ae2bf84a4cfb9d9d61bdf0ba26ab7ce8ca2cd3e87acdf8d5ba423211b4e0869b2f28066b9831fe1d672ed8f97b001bfe873",
"content-encoding": "br",
"content-language": "en",
"x-modernjs-render": "server",
"x-pumbaa-web-avail": "1",
"reporting-endpoints": "csp-endpoint=\"https://mon16-normal-useast5.tiktokv.us/monitor_browser/collect/batch/security/?bid=tiktok_pns\"",
"x-akamai-request-id": "2ad8530e",
"x-bytefaas-request-id": "20251112120606D7A9167A786571027D4C",
"x-origin-response-time": "1529,23.213.246.142",
"content-security-policy": "report-to csp-endpoint; report-uri https://mon16-normal-useast5.tiktokv.us/monitor_browser/collect/batch/security/?bid=tiktok_pns&ev_type=csp&p=Zm6jHcglbkT17wbeLYnRh&v=29; script-src 'inline-speculation-rules' 'report-sample' 'unsafe-eval' *.tiktokcdn-us.com apis.google.com billshark-cdn.s3.amazonaws.com c.paypal.com cdn.ampproject.org cdnjs.cloudflare.com client-api.arkoselabs.com connect.facebook.net developers.kakao.com googleads.g.doubleclick.net interactives.ap.org js-cdn.music.apple.com/musickit/v3/musickit.js js.braintreegateway.com js.hcaptcha.com js.hsforms.net recaptcha.google.com s20.tiktokcdn.com s3.amazonaws.com sf16-website-login.neutral.ttwstatic.com/obj/tiktok_web_login_static/bric-captcha-ttweb/core-captcha/ static.captchami.com tiktok.captchami.com tx41v.arkoselabs.com unpkg.com vimeo.com www.facebook.net www.google.com www.googleadservices.com www.googleapis.com www.googletagmanager.com www.gstatic.com www.vimeo.com; connect-src 'self' blob: bytedance: data: http://localhost:* https://localhost:* wss://*.us.tiktok.com wss://im-ws.tiktok.com *.akamaized.net *.amazonaws.com *.bing.com *.bitssec.com *.braintree-api.com *.braintreegateway.com *.bytelemon.com *.capcut.com *.cloudflare.com *.ctfassets.net *.doubleclick.net *.facebook.com *.facebook.net *.fbsbx.com *.fcdnstatic-intl.com *.fdmstatic.com *.g-p-static.com *.gauthmath.com *.google-analytics.com *.googleadservices.com *.googleapis.com *.googletagmanager.com *.gstatic.com *.ibytedtos.com *.ibyteimg.com *.jumio.ai *.kakao.com *.lemon8-app.com *.lemon8cdn.com *.licdn.com *.linkedin.com *.muscdn.com *.musical.ly *.oecstatic.com *.omise.co *.pangle-ads.com *.paypal.com *.pipopay.com *.pipopay.eu *.pipopayment.com *.pipopayment.eu *.pipopayment.us *.quoracdn.net *.resso.me *.soundon.global *.tableau.com *.tiktok-usts.com *.tiktok.com/passport/ *.tiktokcdn-eu.com *.tiktokcdn-us.com *.tiktokcdn.com *.tiktokcreativeone.com *.tiktokforbusinessoutbound.com *.tiktokglobalshop.us *.tiktokglobalshopv.us *.tiktokmusic.me *.tiktokshops.us *.tiktokstaticb.com *.tiktokus.info *.tiktokv-us.com *.tiktokv.us *.tiktokw.eu/passport/ *.tiktokw.us *.topbuzzcdn.com *.ttwstatic.com *.twitter.com *.us.tiktok.com *.us.tiktokv.com *.vimeo.com *.vodupload.com *.yahoo.co.jp *.yhgfb-static.com affiliate-us.tiktok.com analytics.tiktok.com api.music.apple.com effecthouse.tiktok.com facebook.com im-api.tiktok.com im-image.tiktokv.com image-va.tiktok.com livecenter.tiktok.com login-eu.www.tiktok.com login-no1a.www.tiktok.com login-row.www.tiktok.com login-us.www.tiktok.com newassets.hcaptcha.com newsroom.tiktok.com p0-pu-private-useast8.tiktok.com play.itunes.apple.com scm-us.tiktok.com seller-us.tiktok.com shop.tiktok.com starling-i18n.tiktokv.com/check_and_get_text/ starling-sg.tiktokv.com/check_and_get_text/ starling-va.tiktokv.com/check_and_get_text/ static.captchami.com support.tiktok.com t.co t.tiktok.com tikitoks.com tiktokfollowersfree.com tv.tiktok.com twitter.com unpkg.com us.tiktok.com v16-webapp-prime.tiktok.com v16-webapp.tiktok.com v19-webapp-prime.tiktok.com vas-alisg16.tiktokv.com vas-maliva16.tiktokv.com vas-useast2a.tiktokv.com vas-va.tiktokv.com vcs-sg.tiktokv.com vcs-va.byteoversea.com vcs-va.tiktokv.com verification-i18n.tiktok.com verification-sg.tiktok.com verification-va.byteoversea.com verification-va.tiktok.com verification.tiktokw.eu verification16-normal-no1a.tiktokw.eu verify-sg.byteoversea.com web-app.goidentitas.id web-i18n.tiktok.com/passport/ web-sg.tiktok.com/passport/ web-va.tiktok.com/passport/ webapp-sg.tiktok.com webapp-va.tiktok.com www.tiktok.com; upgrade-insecure-requests ; default-src 'self' 'unsafe-eval' 'unsafe-inline' blob: bytedance: data: wss://*.tiktok.com wss://*.tiktokv.com wss://*.tiktokv.eu wss://tiktok.com wss://tiktokv.com *.adsintegrity.net *.akamaized.net *.amazonaws.com *.arkoselabs.com *.billetlugen.dk *.bing.com *.bitssec.com *.braintree-api.com *.braintreegateway.com *.bytedapm.com *.bytedgame.com *.bytehwm-row.com *.byteicdn.com *.byteintl.com *.byteintl.net *.byteintlapi.com *.byteintlstatic.com *.bytelemon.com *.byteoversea.com *.byteoversea.net *.bytevcloudapi.com *.capcut.com *.cloudflare.com *.ctfassets.net *.doubleclick.net *.entradas.com *.evbuc.com *.eventim.de *.facebook.com *.facebook.net *.fbsbx.com *.fcdnstatic-intl.com *.fdmstatic.com *.g-p-static.com *.gauthmath.com *.giphy.com *.goofy-cdn.com *.goofy.app *.google.com *.googleadservices.com *.googleapis.com *.googletagmanager.com *.gstatic.com *.hsforms.com *.hsforms.net *.ibytedtos.com *.ibyteimg.com *.isnssdk.com *.jumio.ai *.kakao.com *.lemon8-app.com *.lemon8cdn.com *.licdn.com *.linkedin.com *.midtrans.com *.muscdn.com *.musical.ly *.oecstatic.com *.omise.co *.pangle-ads.com *.paypal.com *.pipopay.com *.pipopay.eu *.pipopayment.com *.pipopayment.eu *.pipopayment.us *.quoracdn.net *.resso.me *.sgsnssdk.com *.soundon.global *.tableau.com *.tenor.com *.tiktok-row.net *.tiktok-usts.com *.tiktok.com *.tiktok.ru *.tiktok.vn *.tiktokapis.com *.tiktokcdn-eu.com *.tiktokcdn-in.com *.tiktokcdn-us.com *.tiktokcdn.com *.tiktokcreativeone.com *.tiktokforbusinessoutbound.com *.tiktokglobalshop.com *.tiktokglobalshop.us *.tiktokmusic.me *.tiktokshop.com *.tiktokshops.us *.tiktokstaticb.com *.tiktokus.info *.tiktokv.com *.tiktokv.eu *.tiktokv.us *.tiktokw.eu *.tiktokw.us *.topbuzzcdn.com *.ttcdn-us.com *.ttlivecdn.com *.ttlstatic.com *.ttwstatic.com *.vimeo.com *.vodupload.com *.yahoo.co.jp *.yhgfb-static.com *.youtube-nocookie.com *.zhiliaoapp.com api.music.apple.com code.jquery.com facebook.com google.com i.ticketweb.com images.universe.com interactives.ap.org media.ticketmaster.eu newassets.hcaptcha.com play.itunes.apple.com res.cloudinary.com s1.ticketm.net static-label.frontgatetickets.com static.captchami.com t.co tikitoks.com tiktok.com tiktok.ua tiktok.vn tiktokfollowersfree.com tiktokv.com tx41v.arkoselabs.com unpkg.com vimeo.com; worker-src www.tiktok.com/business/sw.js www.tiktok.com/creator/worker/ www.tiktok.com/embed/sw.js www.tiktok.com/firebase-messaging-sw.js www.tiktok.com/help/sw.js www.tiktok.com/legal/report/verification/uploader-oversea-crc32.js www.tiktok.com/live/creator-networks/pdf.worker.min.js www.tiktok.com/live/static/player-worker/ www.tiktok.com/risk-appeal-ocr/BlinkCardWasmSDK.worker.min.js www.tiktok.com/series/worker/ www.tiktok.com/sw.js www.tiktok.com/tiktokstudio/static/worker/ www.tiktok.com/tiktokstudio/sw.js www.tiktok.com/web-static-js/ www.tiktok.com/webapp-desktop/static/worker/",
"x-bytefaas-execution-duration": "1465.37"
},
"cookies": [
{
"key": "ttwid",
"path": "/",
"value": "1%7C3jOJ27mV-oF7Yzl7FMDi6umzj437uIkx0ALkuao82-M%7C1762949166%7C9abdb8b3a555961ea1abab0d1d62a003d9b848d76f01cd827275cebf049c7d69",
"domain": "",
"secure": true,
"comment": "",
"expires": "Thu, 12 Nov 2026 12:06:06 GMT",
"max-age": "",
"version": "",
"httponly": true,
"samesite": ""
},
{
"key": "webID",
"path": "/",
"value": "7571808997515642399",
"domain": "",
"secure": true,
"comment": "",
"expires": "Wed, 12 Nov 2025 12:11:06 GMT",
"max-age": "",
"version": "",
"httponly": "",
"samesite": ""
}
],
"status_code": 200,
"query": "hoodie",
"task_id": "7394344737739670529",
"created_at": "2025-11-12 12:06:05",
"updated_at": "2025-11-12 12:06:07"
}
]
}
Support
Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.
You can also reach us anytime via email at support@decodo.com.
Feedback
Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.
Have feedback? Share your thoughts on how we can improve.