> ## 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 帖子

> 网页抓取 API TikTok 帖子模板

`tiktok_post` 模板用于获取 TikTok 视频帖子信息。

<Note>
  ### 有用链接

  * 此模板支持[**实时**](https://help.decodo.com/docs/cn/web-scraping-api-real-time-requests)和[**异步**](https://help.decodo.com/docs/cn/web-scraping-api-asynchronous-requests)集成方法。
  * 还支持[**批量**](https://help.decodo.com/docs/cn/web-scraping-api-asynchronous-requests#queue-multiple-tasks)请求。
</Note>

## 输入参数

TikTok 帖子模板可用的请求参数：

| 参数         | 类型      | 必需 | 描述                                                                                                                             |
| ---------- | ------- | -- | ------------------------------------------------------------------------------------------------------------------------------ |
| `target`   | string  | ✅  | 目标类型必须设置为 `tiktok_post`。                                                                                                       |
| `url`      | string  | ✅  | TikTok 帖子 URL                                                                                                                  |
| `headless` | string  |    | 默认情况下，强制 JavaScript 渲染，请在请求中省略参数。                                                                                              |
| `xhr`      | boolean |    | 设置为 `true` 以检索 XHR 和 fetch 请求列表。[**了解更多。**](https://help.decodo.com/docs/cn/web-scraping-api-fetch-and-xhr)<br />默认值为 `false`。 |
| `markdown` | boolean |    | 设置为 `true` 以接收 Markdown 响应。[**了解更多。**](https://help.decodo.com/docs/cn/web-scraping-api-markdown-response)<br />默认值为 `false`。  |

### 请求示例

<CodeGroup>
  ```shellscript cURL theme={null}
  # 将 'TOKEN VALUE' 更新为您的授权令牌
  curl --request 'POST' \
          --url 'https://scraper-api.decodo.com/v2/scrape' \
          --header 'Accept: application/json' \
          --header 'Authorization: Basic TOKEN VALUE' \ 
          --header 'Content-Type: application/json' \
          --data '
      {
        "target": "tiktok_post",
        "url": "https://www.tiktok.com/@nba/video/7255379108241198378"
      }
  '
  ```

  ```javascript Node theme={null}

  const scrape = async() => {
    const response = await fetch("https://scraper-api.decodo.com/v2/scrape", {
      method: "POST",
      body: JSON.stringify({
        "target": "tiktok_post",
        "url": "https://www.tiktok.com/@nba/video/7255379108241198378"
      }),
      headers: {
        "Content-Type": "application/json",
        "Authorization": "Basic TOKEN VALUE" // 更新为您的授权令牌
      },
    }).catch(error => console.log(error));

    console.log(await response.json())
  }

  scrape()
  ```

  ```python Python theme={null}
  import requests
    
  url = "https://scraper-api.decodo.com/v2/scrape"
    
  payload = {
        "target": "tiktok_post",
        "url": "https://www.tiktok.com/@nba/video/7255379108241198378"
  }
    
  headers = {
      "accept": "application/json",
      "content-type": "application/json",
      "authorization": "Basic TOKEN VALUE" # 更新为您的授权令牌
  }
    
  response = requests.post(url, json=payload, headers=headers)
    
  print(response.text)
  ```
</CodeGroup>

## 输出

#### 响应示例

<CodeGroup>
  ```json JSON expandable theme={null}
  {
    "results": [
        {
            "content":"<!DOCTYPE html><html lang=\"en\" data-tux-color-scheme=\"dark\" dir=\"ltr\" data-theme=\"dark\" data-rh=\"lang,data-theme\"><head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n    <title>Jarace Walker's Epic Dunk and Free Throw Fight in NBA Summer League | TikTok</title>...",
            "headers": {
                "date": "Wed, 12 Nov 2025 12:53:09 GMT",
                "pragma": "no-cache",
                "server": "nginx",
                "expires": "Wed, 12 Nov 2025 12:53:09 GMT",
                "x-cache": "TCP_MISS from a2-16-76-118.deploy.akamaitechnologies.com (AkamaiGHost/22.3.2-3132366524ab32492078dda91c109cd6) (-)",
                "x-tt-logid": "20251112125309E88141BA602BAD048C96",
                "content-type": "text/html; charset=utf-8",
                "x-gw-dst-psm": "serverless.tiktok.desktop",
                "x-powered-by": "Goofy Node",
                "cache-control": "max-age=0, no-cache, no-store",
                "server-timing": "cdn-cache; desc=MISS, edge; dur=134, origin; dur=248, inner; dur=240",
                "x-tt-trace-id": "00-251112125309E88141BA602BAD048C96-166FABFD42867EFA-00",
                "content-length": "73627",
                "feature-policy": "microphone 'none'; geolocation 'none'",
                "x-cache-remote": "TCP_MISS from a23-3-98-145.deploy.akamaitechnologies.com (AkamaiGHost/22.3.2-3132366524ab32492078dda91c109cd6) (-)",
                "x-firefox-spdy": "h2",
                "x-tt-trace-tag": "id=16;cdn-cache=miss;type=dyn",
                "referrer-policy": "strict-origin-when-cross-origin",
                "x-frame-options": "SAMEORIGIN",
                "x-tt-trace-host": "010496ce52589096e8b8561140c69cf2f1916d700704a988df845a295b912172af7b43618caa4417c879ec9e0471ad79a4f6046a69ff74fa30046e3a59e095371080a131c291177aa3fcdb17ae7438b901013820b038b26df921d346d393f532334e07e47946d4b56a9380063724516470",
                "content-encoding": "br",
                "x-xss-protection": "1; mode=block",
                "x-download-options": "noopen",
                "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": "587a08b9.25ff838",
                "x-bytefaas-request-id": "20251112125309E88141BA602BAD048C96",
                "x-content-type-options": "nosniff",
                "x-origin-response-time": "248, 23.3.98.145",
                "x-parent-response-time": "340, 2.16.76.118",
                "content-security-policy": "report-uri https://mon16-normal-useast5.tiktokv.us/monitor_browser/collect/batch/security/?bid=tiktok_pns&ev_type=csp&p=HOiLPthVoUcWRLsWj0mtJ&v=16; report-to csp-endpoint; 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 *.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 *.evbuc.com *.eventim.de *.facebook.com *.facebook.net *.fbsbx.com *.fcdnstatic-intl.com *.fdmstatic.com *.g-p-static.com *.gauthmath.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 *.pipopayment.us *.redditstatic.com *.resso.me *.sgsnssdk.com *.soundon.global *.tableau.com *.tiktok-row.net *.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 *.tiktokmusic.me *.tiktokshop.com *.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 media.ticketmaster.eu 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 unpkg.com vimeo.com; connect-src * 'unsafe-inline' blob: data:; frame-src bytedance: *.kakao.com *.tiktok.com access.line.me accounts.google.com api.twitter.com appleid.apple.com assets.braintreegateway.com client-api.arkoselabs.com h.online-metrix.net lf16-web.tiktokcdn.com newassets.hcaptcha.com recaptcha.google.com tx41v.arkoselabs.com www.facebook.com www.google.com; script-src 'inline-speculation-rules' 'report-sample' 'unsafe-eval' *.tiktokcdn-us.com apis.google.com billshark-cdn.s3.amazonaws.com c.paypal.com cdnjs.cloudflare.com client-api.arkoselabs.com connect.facebook.net developers.kakao.com googleads.g.doubleclick.net 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 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; worker-src www.tiktok.com/business/sw.js www.tiktok.com/embed/sw.js www.tiktok.com/firebase-messaging-sw.js www.tiktok.com/help/sw.js 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/; frame-ancestors tea-va.bytedance.net www.tiktok.com",
                "strict-transport-security": "max-age=31536000; includeSubdomains",
                "access-control-expose-headers": "x-tt-traceflag, x-tt-logid",
                "x-bytefaas-execution-duration": "238.86",
                "content-security-policy-report-only": "report-uri https://mon16-normal-useast5.tiktokv.us/monitor_browser/collect/batch/security/?bid=tiktok_pns&ev_type=csp&p=HOiLPthVoUcWRLsWj0mtJ&v=5; report-to csp-endpoint; script-src 'report-sample' 'unsafe-eval' *.tiktokcdn-us.com apis.google.com billshark-cdn.s3.amazonaws.com c.paypal.com client-api.arkoselabs.com connect.facebook.net developers.kakao.com js.braintreegateway.com js.hcaptcha.com js.hsforms.net recaptcha.google.com s20.tiktokcdn.com s3.amazonaws.com static.captchami.com tiktok.captchami.com unpkg.com www.facebook.net www.vimeo.com; worker-src www.tiktok.com/business/sw.js www.tiktok.com/embed/sw.js www.tiktok.com/firebase-messaging-sw.js www.tiktok.com/help/sw.js www.tiktok.com/sw.js; frame-ancestors tea-va.bytedance.net www.tiktok.com"
            },
            "cookies": [
                {
                    "key": "msToken",
                    "path": "/",
                    "value": "DFkQB09-nFMRew2aInG22KQtPwyBcr5xrcbdi_Hl_NnII7LQNy14t9Rhk4VBOBr7YrHqjb9kDweDBbusU5VjF6_D2-QxR5iN4S_7BFDtecwDLGO_GKpjlLJYkzISKv8z_JjXQvb7OHrwtLsU9cQR",
                    "domain": "www.tiktok.com",
                    "secure": false,
                    "comment": "",
                    "expires": 1770728008,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                },
                {
                    "key": "ttwid",
                    "path": "/",
                    "value": "1%7CaWPieN9SbnRw8cLxkmAZB1p9TxCM_NfwVXa6MNoO5Qk%7C1762950723%7C90568615d2cb887f334b6dbadcebec1cf0e085f9c594ecba3683fb977a289216",
                    "domain": ".tiktok.com",
                    "secure": true,
                    "comment": "",
                    "expires": -1,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                },
                {
                    "key": "tt_csrf_token",
                    "path": "/",
                    "value": "VjErxEtr-_PAGD2GKQzwZdJ-c3FtCEslLoT0",
                    "domain": ".tiktok.com",
                    "secure": true,
                    "comment": "",
                    "expires": -1,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                },
                {
                    "key": "delay_guest_mode_vid",
                    "path": "/",
                    "value": "8",
                    "domain": ".www.tiktok.com",
                    "secure": true,
                    "comment": "",
                    "expires": -1,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                },
                {
                    "key": "odin_tt",
                    "path": "/",
                    "value": "5f6b49699d0b53cd40e7ceea1f721afe3b5f9368f212ed7ecf19c7f06cfd436ff73d1a86b7cb49928bd02132515bbd92726393d3d0bc8bcfac335d28cb7983e7071788a86539ca39372aada3b5586019",
                    "domain": ".tiktok.com",
                    "secure": false,
                    "comment": "",
                    "expires": -1,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                },
                {
                    "key": "tt_chain_token",
                    "path": "/",
                    "value": "laiMM6/qjq5IbyCM5JsoBQ==",
                    "domain": ".tiktok.com",
                    "secure": true,
                    "comment": "",
                    "expires": 1778503989,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                },
                {
                    "key": "tiktok_webapp_theme_source",
                    "path": "/",
                    "value": "auto",
                    "domain": ".www.tiktok.com",
                    "secure": true,
                    "comment": "",
                    "expires": 1788871992,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                },
                {
                    "key": "tiktok_webapp_theme",
                    "path": "/",
                    "value": "dark",
                    "domain": ".www.tiktok.com",
                    "secure": true,
                    "comment": "",
                    "expires": 1788871992,
                    "max-age": "",
                    "version": "",
                    "httponly": "",
                    "samesite": ""
                }
            ],
            "status_code": 200,
            "task_id": "7394356565161054209",
            "created_at": "2025-11-12 12:53:05",
            "updated_at": "2025-11-12 12:53:30"
        }
    ]
  }
  ```
</CodeGroup>

### 从 TikTok 帖子下载视频

<Warning>
  下载视频需要使用 TikTok 账户登录。
</Warning>

使用 `tiktok_post` 目标可以获取视频的下载链接。响应中提供了 `downloadAddr` 属性：

<CodeGroup>
  ```json JSON wrap theme={null}
  {
      ...
      "downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oAfTW9DAAQAiFwwZ3mBwqzEOKIKqEOIgti2Chv/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=tiktok_m&cd=0%7C0%7C1%7C&cv=1&br=3762&bt=1881&cs=0&ds=3&ft=4KJMyMzm8Zmo08z.f-4jV~KlQpWrKsd.&mime_type=video_mp4&qs=0&rc=aTRnZGRpNTdnOWRpaDM3ZEBpM2ppdXE5cjR1czMzODczNEBiLzVjYDNfNTIxLjJfNGM2YSNvLm5gMmRzXl5gLS1kMTFzcw%3D%3D&btag=e00088000&expire=1723138617&l=202408081136144AE053D9571E5409C917&ply_type=2&policy=2&signature=0c5da3af3e3372d1e71a7748d8afaec4&tk=tt_chain_token",
      ...
  }
  ```
</CodeGroup>

下载视频需要登录 TikTok。登录后，应从 cookies 中复制 `tt_chain_token`：

<Frame>
  <img src="https://mintcdn.com/decodo/7ZKpc3GV1DKO_XQr/images/docs/04cfa29-how_to_use_spoons_2024-08-08_at_15.50.22.png?fit=max&auto=format&n=7ZKpc3GV1DKO_XQr&q=85&s=22d727863be89e862a9bad6b0bb2eac4" alt="" width="1920" height="886" data-path="images/docs/04cfa29-how_to_use_spoons_2024-08-08_at_15.50.22.png" />
</Frame>

使用此令牌，可以通过向 `downloadAddr` 发送 `GET` 请求并将 `tt_chain_token` 作为 cookie 附加来下载视频：

```shellscript wrap theme={null}
curl -L 'https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oEdn6roI2PQhqH6MAmgIjaeLfeKPnkIoDGsCAh/?a=1988&bti=NDU3ZjAwOg%3D%3D&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=1474&bt=737&cs=0&ds=6&ft=4fUEKMVc8Zmo0s_.f-4jVL.1upWrKsd.&mime_type=video_mp4&qs=5&rc=ZTY1N2g0OjtpaGk2Zjc8OUBpM2ppdXE5cjR1czMzODczNEBiMS5iNS5iXzExMjItNDMwYSNvLm5gMmRzXl5gLS1kMTFzcw%3D%3D&btag=e00088000&expire=1723289013&l=2024080811224972CD300C450534682E98&ply_type=2&policy=2&signature=08bf7eda0e60d6c3ca0865ff1db58640&tk=tt_chain_token' \
     -H 'Cookie: tt_chain_token=P+R8i1eNHk3uHmoxvinB9A=='
```

如果下载大量内容，您的请求可能会被阻止。使用 `universal` 目标，并手动更改 `tt_chain_token` 将克服阻止。

***

<Columns cols={2}>
  <Card title="支持" href="https://direct.lc.chat/12092754" cta="让我们聊聊！">
    需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。 \
    您也可以随时通过电子邮件 [support@decodo.com](mailto:support@decodo.com) 联系我们。
  </Card>

  <Card title="反馈" href="mailto:feedback@decodo.com" cta="分享反馈">
    找不到您要找的内容？请求一篇文章！ \
    有反馈意见？分享您对我们如何改进的想法。
  </Card>
</Columns>
