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

# 5分钟内抓取你的第一个TikTok个人资料

> 在5分钟内设置Bright Data TikTok爬虫API并收集您的第一个个人资料数据。

本教程将向你展示如何使用 Bright Data TikTok Scraper API 抓取 TikTok 个人资料并获得结构化的 JSON 数据。

## 前置条件

* 一个 [Bright Data 账户](https://www.bright.cn/cp/start)（每月含 5,000 个免费积分）
* 已安装 cURL、Python 3 或 Node.js 18+

<Steps>
  <Step title="获取你的 API 密钥">
    转到你的 Bright Data 账户中的[用户设置页面](https://www.bright.cn/cp/setting/users)并复制你的 API 密钥。

    如果你还没有账户，请[在 brightdata.com 注册](https://www.bright.cn/cp/start)。新账户每月可获得 5,000 个免费积分，无需信用卡。请参阅[免费套餐](/cn/general/account/billing-and-pricing/free-tier)。

    <Warning>
      你的 API 密钥仅在创建时显示一次。请安全地复制并存储它。
    </Warning>
  </Step>

  <Step title="发送请求">
    我们将使用**配置文件端点**进行同步请求。用你的实际密钥替换 `YOUR_API_KEY`：

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1villgoiiidt09ci", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.tiktok.com/@tiktok"}],
      )

      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.tiktok.com/@tiktok" }
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    你应该会看到 `200` 状态码。这需要 10-30 秒的时间。
  </Step>

  <Step title="检查响应">
    Bright Data TikTok Scraper API 返回一个包含结构化个人资料数据的 JSON 数组：

    ```json theme={null}
    [
      {
        "nickname": "TikTok",
        "account_id": "tiktok",
        "biography": "Make your day.",
        "followers": 85600000,
        "following": 580,
        "likes": 520000000,
        "videos_count": 1250,
        "is_verified": true,
        "url": "https://www.tiktok.com/@tiktok"
      }
    ]
    ```

    每个个人资料对象都包括涵盖粉丝数、个人简介、验证状态等字段。请参阅[完整响应架构](/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url)。
  </Step>
</Steps>

你已成功使用 Bright Data TikTok Scraper API 抓取了你的第一个 TikTok 个人资料。

## 常见问题

<Accordion title="我可以在一个请求中抓取多个个人资料吗？">
  可以。将更多对象添加到输入数组中。同步请求支持最多 20 个 URL。对于更大的批次，请使用[异步 `/trigger` 端点](/products/scrapers/scrapers-library/async-requests)。

  ```json theme={null}
  [
    {"url": "https://www.tiktok.com/@tiktok"},
    {"url": "https://www.tiktok.com/@charlidamelio"},
    {"url": "https://www.tiktok.com/@khaby.lame"}
  ]
  ```
</Accordion>

<Accordion title="收到 401 或 403 错误？">
  验证你的 API 密钥是否正确且未过期。从[账户设置](https://www.bright.cn/cp/setting/users)生成新密钥。详见[身份验证指南](/api-reference/authentication)。
</Accordion>

<Accordion title="请求超时？">
  同步请求的超时时间为 1 分钟。如果请求超过此限制，它将自动切换到异步模式并返回一个 `snapshot_id`。对于大型批次，请使用[异步工作流](/products/scrapers/scrapers-library/async-requests)。
</Accordion>

<Accordion title="响应数据为空或不完整？">
  验证 TikTok 个人资料 URL 是否可公开访问且格式正确。URL 应遵循 `https://www.tiktok.com/@username` 的模式。
</Accordion>

## 后续步骤

<CardGroup cols={3}>
  <Card title="发送你的第一个请求" icon="bolt" href="/products/scrapers/tiktok/send-first-request">
    探索所有五个端点类型及完整示例。
  </Card>

  <Card title="异步批量请求" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    在单个批量任务中抓取数百个 URL。
  </Card>

  <Card title="设置 Webhook" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    在抓取完成时自动接收结果。
  </Card>
</CardGroup>