Tài liệuScraping APIAmazon ScraperBắt đầu nhanh

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

Yêu cầu một sản phẩm Amazon bằng cURL và đọc kết quả có cấu trúc của nó. Hướng dẫn từng bước này sử dụng ví dụ yêu cầu từ tài liệu tham khảo Product API.

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.

Ví dụ mẫu sử dụng một URL sản phẩm từ tài liệu tham khảo API. Bạn có thể thay thế nó bằng URL sản phẩm Amazon mà bạn muốn truy xuất. Tình trạng còn hàng của sản phẩm và các giá trị trả về có thể thay đổi.

1. Gửi yêu cầu

Thay thế YOUR_API_KEY bằng key của 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.amazon",
  "input": {
    "type": "product",
    "url": "https://www.amazon.com/dp/B0BQXHK363",
    "zip_code": ""
  }
}'

Phần thân yêu cầu chọn actor Amazon, đặt type thành product và cung cấp url của sản phẩm. Giá trị zip_code rỗng khớp với ví dụ chính thức; hãy cung cấp mã bưu chính khi bạn cần thông tin giao hàng cho vị trí đó.

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

HTTP 200 cho biết đã hoàn thành. Dưới đây là một tập con các trường của ví dụ phản hồi Product đã công bố, không phải một lần thu thập mới:

{
  "asin": "B0BQXHK363",
  "availability": "In Stock",
  "final_price": "$44.99",
  "rating": "4.0",
  "reviews_count": "115"
}

Giá, xếp hạng và số lượng đánh giá trong ví dụ này là các chuỗi (string). Hãy giữ nguyên kiểu dữ liệu được trả về khi đọc payload, và chuyển đổi chúng một cách tường minh nếu ứng dụng của bạn cần các giá trị số. Các trường khác trong ví dụ đầy đủ bao gồm title, images và variations.

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

Phản hồi HTTP 201 trả về một task ID. Tài liệu tham khảo API cho thấy:

{
  "message": "task in progress",
  "taskId": "a8af123c-0f81-477d-a2e7-c57ad18fe54a"
}

Sử dụng ID từ phản hồi của chính bạn, không phải ID trong ví dụ, trong yêu cầu này:

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

Nếu tác vụ vẫn đang xử lý, hãy tiếp tục theo Kết quả và Polling. Sử dụng chính sách thử lại có giới hạn thay vì liên tục gửi lại cùng một yêu cầu sản phẩm.

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

Kiểm tra cả trạng thái HTTP và phần thân phản hồi. Tài liệu tham khảo Product bao gồm một ví dụ 400 với code: 20500 và message: "scraping failed". Kiểm tra key, URL sản phẩm và JSON đầu vào. Làm theo hướng dẫn polling chung để xử lý giới hạn tốc độ (rate limit) và lỗi máy chủ.

Các bước tiếp theo

Tiếp tục đến Endpoints để tìm hiểu các yêu cầu Seller, Keyword search và Rufus. Xem lại tài liệu tham khảo Product API để có ví dụ đầy đủ đã công bố.

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