> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Shop URL

> Web Data API TikTok Shop Template

The `tiktok` template is built to obtain content directly from various TikTok Shop URLs.

<Note>
  ### Useful Links

  * [**Real-time**](https://help.decodo.com/docs/web-data-api-scrape-real-time-requests) and [**Asynchronous**](https://help.decodo.com/docs/web-data-api-scrape-asynchronous-requests) integration methods are available for this template.
  * [**Batch**](https://help.decodo.com/docs/web-data-api-scrape-asynchronous-requests#queue-multiple-tasks) requests are also supported.
</Note>

## Input Parameters

Request parameters available for the TikTok Shop URL template:

| Parameter | Type | Required | Description |
| - | - | - | - |
| `target` | string | ✅ | Target type must be set to `tiktok`. |
| `url` | string | ✅ | A URL of a TikTok page. Additional parameters can be specified in the URL itself. |
| `headless` | string | | `html` value enables JavaScript rendering. [**Read more.**](https://help.decodo.com/docs/web-data-api-scrape-javascript-rendering)<br />`png` value enables screenshot response. [**Read more.**](https://help.decodo.com/docs/web-data-api-screenshot-response) |
| `device_type` | string | | Specify device type and browser. [**Read more.**](https://help.decodo.com/docs/web-data-api-scrape-device-types) |
| `xhr` | boolean | | Set to `true` to retrieve a list of XHR and fetch requests. [**Read more.**](https://help.decodo.com/docs/web-data-api-fetch-and-xhr) <br />Default value is `false`. |
| `markdown` | boolean | | Set to `true` to receive a Markdown response. [**Read more.**](https://help.decodo.com/docs/web-data-api-markdown-response) <br />Default value is `false`. |

### Request Examples

<CodeGroup>
  ```shellscript cURL theme={null}
  # 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",
        "url": "https://www.tiktok.com/shop/s?q=HEADPHONES"
      }
  '
  ```

  ```javascript Node theme={null}

  const scrape = async() => {
    const response = await fetch("https://data.decodo.com/v1/scrape", {
      method: "POST",
      body: JSON.stringify({
        "target": "tiktok",
        "url": "https://www.tiktok.com/shop/s?q=HEADPHONES"
      }),
      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()
  ```

  ```python Python theme={null}
  import requests
    
  url = "https://data.decodo.com/v1/scrape"
    
  payload = {
        "target": "tiktok",
        "url": "https://www.tiktok.com/shop/s?q=HEADPHONES"
  }
    
  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)
  ```
</CodeGroup>

## Output

#### Response Example

<CodeGroup>
  ```json JSON expandable theme={null}
  {
    "results": [
        {
            "content": "<!DOCTYPE html><html dir=\"ltr\" data-tux-color-scheme=\"light\"><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1,shrink-to-fit=no,viewport-fit=cover,minimum-scale=1,maximum-scale=1,user-scalable=no\"><meta http-equiv=\"x-ua-compatible\" content=\"ie=edge\"><meta name=\"renderer\" content=\"webkit\"><meta name=\"layoutmode\" content=\"standard\"><meta name=\"imagemode\" content=\"force\"><meta name=\"wap-font-scale\" content=\"no\"><meta name=\"f...",
            "headers": {
                "cache-control": "max-age=0, no-cache, no-store",
                "content-encoding": "br",
                "content-language": "en",
                "content-security-policy": "report-uri https://mon16-normal-useast5.tiktokv.us/monitor_browser/collect/batch/security/?bid=tiktok_pns&ev_type=csp&p=Zm6jHcglbkT17wbeLYnRh&v=32; script-src 'inline-speculation-rules' 'report-sample' 'unsafe-eval' *.tiktokcdn-us.com accounts.google.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 *.redditstatic.com *.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 accounts.google.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 *.redditstatic.com *.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/coin/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/; report-to csp-endpoint",
                "content-type": "text/html; charset=UTF-8",
                "date": "Thu, 18 Dec 2025 07:20:43 GMT",
                "expires": "Thu, 18 Dec 2025 07:20:43 GMT",
                "pragma": "no-cache",
                "reporting-endpoints": "csp-endpoint=\"https://mon16-normal-useast5.tiktokv.us/monitor_browser/collect/batch/security/?bid=tiktok_pns\"",
                "server": "nginx",
                "server-timing": "inner; dur=1063, bd-edenx-server-loader-shop_(route_page_name)_page; dur=896.999836, bd-edenx-server-loader; dur=899.000168, bd-edenx-ssr-prerender; dur=45.000076, bd-edenx-ssr-render-html; dur=46.000004, cdn-cache; desc=MISS, edge; dur=1, origin; dur=1143",
                "vary": "Accept-Encoding, User-Agent",
                "x-akamai-request-id": "363606a",
                "x-bytefaas-execution-duration": "1060.51",
                "x-bytefaas-request-id": "202512180720422A3B2090530FBD01D265",
                "x-cache": "TCP_MISS from a23-211-119-70.deploy.akamaitechnologies.com (AkamaiGHost/22.3.3.1-d99a9e98b7d52dde86bd4d85ef9e7108) (-)",
                "x-firefox-spdy": "h2",
                "x-gw-dst-psm": "i18n_ecom_fe.growth.brandy_desktop",
                "x-modernjs-render": "server",
                "x-origin-response-time": "1144, 23.211.119.70",
                "x-powered-by": "Goofy Node",
                "x-pumbaa-web-avail": "1",
                "x-tt-logid": "202512180720422A3B2090530FBD01D265",
                "x-tt-trace-host": "01150df7649323448fe1d05d7d68acd7415da8df5a99564ab78bbb21c8cb8f9f7c159ce1f1729d02ced9a0d0aac8dd84698e8ff6d49349257182bd02a6b0ff6dd7b4e7bcaa665b3a6f63d8444d4ac96b572fd03cdb29752d485b7c42cb5d8d29a3",
                "x-tt-trace-id": "00-2512180720422A3B2090530FBD01D265-056F08F627FDDC79-00",
                "x-tt-trace-tag": "id=16;cdn-cache=miss;type=dyn"
            },
            "cookies": [
                {
                    "comment": "",
                    "domain": "www.tiktok.com",
                    "expires": 1773818454,
                    "httponly": "",
                    "key": "msToken",
                    "max-age": "",
                    "path": "/",
                    "samesite": "",
                    "secure": false,
                    "value": "2k4zNBag7qcpi9xndBLTl2LjVL0g19UwKdRas-N4THDM6Ccrag04wnLOiGVx3KoFgRltnhrXWsz2MNoRwWkKDr_X-p8LLfw--XVhm53RwKRLjUiVrqHxRAzrVomq9d2OOwIUvw==",
                    "version": ""
                },
                {
                    "comment": "",
                    "domain": "www.tiktok.com",
                    "expires": -1,
                    "httponly": "",
                    "key": "dkms-type",
                    "max-age": "",
                    "path": "/",
                    "samesite": "",
                    "secure": true,
                    "value": "0",
                    "version": ""
                },
                {
                    "comment": "",
                    "domain": "www.tiktok.com",
                    "expires": 1797578448,
                    "httponly": "",
                    "key": "ttwid",
                    "max-age": "",
                    "path": "/",
                    "samesite": "",
                    "secure": true,
                    "value": "1%7Cm2IbV5jqcZF8vsrbeNew7teZ5gBYhCv3kzdBi6bmMWY%7C1766042442%7C426b13235027abba8759ec4a73671c477283938b83d645048e22131d7ab39ec9",
                    "version": ""
                },
                {
                    "comment": "",
                    "domain": "www.tiktok.com",
                    "expires": -1,
                    "httponly": "",
                    "key": "dkms-token",
                    "max-age": "",
                    "path": "/",
                    "samesite": "",
                    "secure": true,
                    "value": "MIGPBAwNcNxZ67l9IaBpqO8EbYQXoUrvXz5gsM+6Tie4sqG+28IjrGKFiAl3I8uZ1Y3HJjgJ0eY9E/Ejf17TK8JJogWpEwJYlJ/OeSGvhM9AgYineae4VKi0pvmqS6ZqetQQVey8tEA/4cu3zdjewQUwcMNUiwpQgq9VGFEwKPAEENAOEMZW4F2QouruJILhmXc=",
                    "version": ""
                },
                {
                    "comment": "",
                    "domain": "www.tiktok.com",
                    "expires": -1,
                    "httponly": "",
                    "key": "s_v_web_id",
                    "max-age": "",
                    "path": "/",
                    "samesite": "",
                    "secure": false,
                    "value": "verify_mjb42qpj_eBmnhrH9_wDpL_449U_ACdN_4DGjQ7pkSURz",
                    "version": ""
                }
            ],
            "status_code": 200,
            "task_id": "7407318869515217921",
            "created_at": "2025-12-18 07:20:39",
            "updated_at": "2025-12-18 07:20:58",
            "type": "raw"
        }
    ]
  }
  ```
</CodeGroup>

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    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](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.