Các endpoint của TikTok Scraper

Hãy chọn actor TikTok phù hợp với dữ liệu bạn cần. Mỗi thao tác đều dùng chung một endpoint yêu cầu HTTP, nhưng actor và các trường đầu vào sẽ khác nhau.

Yêu cầu và xác thực

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

Thay YOUR_API_KEY bằng khóa API Scrapeless của bạn. Gửi một đối tượng JSON chứa actor và input.

Chọn một thao tác

User Detail

Truyền tên người dùng của tài khoản vào unique_id, như trong ví dụ chính thức:

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"
  }
}'

Phản hồi đã công bố bao gồm account_id, unique_id, sec_uid, nickname, profile_url, avatar, statistics, và các cờ tài khoản như is_verified.

Hãy lưu lại sec_uid nếu bạn muốn gọi User Work. Tên người dùng, ID tài khoản và sec_uid là những giá trị riêng biệt; đừng thay thế cái này bằng cái khác.

Tài liệu tham khảo API User Detail

User Work

Lấy các bài đăng của một tài khoản bằng sec_uid của nó. Yêu cầu bên dưới dùng cùng một mã định danh tài khoản như trong phản hồi User Detail chính thức; hãy thay nó bằng sec_uid lấy từ yêu cầu hồ sơ đã hoàn tất của chính bạn.

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.work",
  "input": {
    "sec_uid": "MS4wLjABAAAAIb0gpCf24bC1i5TWl87J5SjS0h7ZB59nfledznAyQ_DF7-vpgJJ8nYfzo98Ba3fp",
    "cursor": "0",
    "count": 10
  }
}'

Ví dụ thành công chứa một mảng items. Đoạn trích này giữ lại một số trường được chọn từ mục đầu tiên của nó:

{
  "items": [
    {
      "post_id": "7673888001365150989",
      "post_url": "https://www.tiktok.com/@teamtrump/video/7673888001365150989",
      "play_count": 572300,
      "like_count": 31000
    }
  ]
}

Mục đầy đủ cũng bao gồm thông tin về video và tác giả. Tài liệu tham khảo ghi nhận một đầu vào cursor nhưng ví dụ phản hồi của nó không bao gồm con trỏ trang tiếp theo hay trường has_more. Đừng xây dựng một vòng lặp phân trang giả định rằng một trong hai trường đó tồn tại.

Tài liệu tham khảo API User Work

Shop Page

Lấy chi tiết sản phẩm bằng ID sản phẩm TikTok Shop và khu vực. Cả hai đầu vào đều là chuỗi bắt buộc. Yêu cầu này giữ lại giá trị gb của ví dụ chính thức:

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.shop.page",
  "input": {
    "product_id": "1729411983267761850",
    "region": "gb"
  }
}'

Giá trị region được trả về đại diện cho khu vực thực tế trên trang sản phẩm. Tập con này của ví dụ đã công bố cho thấy các kiểu của trường; giá và số lượng là các giá trị ví dụ lịch sử:

{
  "product_id": "1729411983267761850",
  "region": "GB",
  "sold_count": "17644",
  "price": {
    "currency": "GBP",
    "sale_price": "5.78"
  },
  "rating": 4.5,
  "review_count": "823"
}

Ví dụ đầy đủ cũng bao gồm stock, images, options, skus, seller, và shipping_options. Hãy giữ ID sản phẩm ở dạng chuỗi; ví dụ cũng biểu diễn sold_count, review_count và price.sale_price dưới dạng chuỗi.

Tài liệu tham khảo API Shop Page

Xử lý kết quả tác vụ

Phản hồi HTTP 200 chứa kết quả đã hoàn tất. Phản hồi HTTP 201 có nghĩa là quá trình xử lý vẫn đang diễn ra; hãy lưu taskId của nó và truy xuất tác vụ đó bằng:

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

Thay YOUR_TASK_ID bằng ID được trả về từ yêu cầu của bạn. Hãy làm theo Kết quả và Polling để biết khoảng thời gian polling và giới hạn thử lại.

Hãy kiểm tra cả nội dung lỗi lẫn mã trạng thái HTTP. Phản hồi 400 có thể bao gồm code: 20500 và message: "scraping failed"; đó không phải là một phản hồi dữ liệu thành công. Hãy kiểm tra mục tiêu và các đầu vào của yêu cầu trước khi thử lại.

Ví dụ phản hồi

Các đoạn trích trên trang này là tập con của các ví dụ API chính thức, không phải kết quả trực tiếp từ các yêu cầu mẫu. Hãy đọc tài liệu tham khảo thao tác được liên kết để xem toàn bộ payload và xử lý các giá trị bị thiếu theo nhu cầu của ứng dụng của bạn.