Bắt đầu nhanh với TikTok Scraper

Truy xuất một hồ sơ tài khoản TikTok bằng actor User Detail. Hướng dẫn này sử dụng tên người dùng và yêu cầu từ ví dụ User Detail chính thức.

Trước khi bắt đầu

Bạn cần một tài khoản Scrapeless, một API key hợp lệ và cURL. Lấy key của bạn từ bảng điều khiển Scrapeless.

1. Gửi một yêu cầu hồ sơ

Thay YOUR_API_KEY bằng key của bạn. Bạn có thể thay teamtrump bằng tên người dùng mà bạn muốn truy xuất. Như trong ví dụ chính thức, hãy truyền chính tên người dùng thay vì URL hồ sơ.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.tiktok.user.detail",
  "input": {
    "unique_id": "teamtrump"
  }
}'

actor chọn scraper.tiktok.user.detail. Trường bắt buộc input.unique_id xác định tài khoản.

2. Đọc một kết quả đã hoàn thành

Phản hồi HTTP 200 trả về dữ liệu hồ sơ. Đây là một tập con của ví dụ phản hồi đã công bố, không phải một lần thu thập mới:

{
  "account_id": "7365161718782395438",
  "unique_id": "teamtrump",
  "sec_uid": "MS4wLjABAAAAIb0gpCf24bC1i5TWl87J5SjS0h7ZB59nfledznAyQ_DF7-vpgJJ8nYfzo98Ba3fp",
  "nickname": "Team Trump",
  "profile_url": "https://www.tiktok.com/@teamtrump",
  "is_verified": true
}

Ví dụ đầy đủ cũng bao gồm avatar và statistics. Các giá trị statistics của nó là chuỗi. Lưu lại sec_uid thực tế từ kết quả đã hoàn thành của bạn nếu bạn muốn yêu cầu các bài đăng của tài khoản bằng User Work.

3. Truy xuất một tác vụ vẫn đang xử lý

Nếu bạn nhận được HTTP 201, hãy đọc taskId từ phản hồi và thay YOUR_TASK_ID bên dưới:

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

Sử dụng Kết quả và Polling để biết khoảng thời gian polling và giới hạn thử lại. Hãy tái sử dụng task ID đã trả về thay vì tạo một yêu cầu hồ sơ trùng lặp.

Nếu yêu cầu thất bại

Kiểm tra trạng thái HTTP và nội dung phản hồi. Tài liệu tham khảo User Detail ghi nhận một phản hồi 400 với code và message, và bao gồm ví dụ lỗi code: 20500, message: "scraping failed". Kiểm tra tên người dùng đầu vào và xác thực trước khi thử lại.

Các bước tiếp theo

Tiếp tục đến Endpoints để yêu cầu các bài đăng bằng sec_uid hoặc truy xuất một sản phẩm Shop bằng product_id và region.

Giới thiệu Điểm cuối