Các endpoint của Amazon Scraper

Sử dụng actor scraper.amazon cho mọi thao tác trên trang này. Chọn thao tác bằng input.type và cung cấp các đầu vào tương ứng.

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 duy nhất chứa actor và input.

Chọn một thao tác

Thao tác	`input.type`	Đầu vào được dùng bên dưới
Product	`product`	`url`, `zip_code`
Seller	`seller`	`url`, `zip_code`
Tìm kiếm theo từ khóa	`keywords`	`keywords`, `page`, `domain`, `zip_code`
Rufus	`rufus`	`keywords`, `domain`

Product

Cung cấp một URL sản phẩm Amazon. Schema Product yêu cầu url; zip_code cung cấp thông tin về vị trí giao hàng.

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 hồi được công bố bao gồm asin, title, availability, final_price, rating, reviews_count, images, và variations. Xem Quickstart để có ví dụ phản hồi rút gọn.

Tài liệu tham khảo Product API

Seller

Cung cấp một URL trang người bán. Bao gồm zip_code: schema Seller đánh dấu trường này là bắt buộc, và ví dụ yêu cầu của nó sử dụng một chuỗi rỗng.

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": "seller",
    "url": "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
    "zip_code": ""
  }
}'

Tài liệu tham khảo Seller định nghĩa phản hồi thành công là một đối tượng JSON không có schema hay ví dụ ở cấp trường. Hãy kiểm tra payload trả về trước khi ánh xạ các trường người bán trong ứng dụng của bạn.

Tài liệu tham khảo Seller API

Tìm kiếm theo từ khóa

Cung cấp văn bản tìm kiếm trong keywords. Sử dụng page để chọn một trang kết quả tìm kiếm. Ví dụ bên dưới tuân theo giá trị trang dạng số đã được ghi trong tài liệu và sử dụng domain: "com" cho Amazon.com; nó bỏ qua bộ lọc phòng ban tùy chọ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": "keywords",
    "keywords": "Iphone+14+Pro+512GB",
    "page": 1,
    "domain": "com",
    "zip_code": ""
  }
}'

Đầu vào	Cách dùng
`keywords`	Từ khóa tìm kiếm; bắt buộc theo schema thao tác.
`page`	Số trang kết quả tìm kiếm.
`domain`	Thiết lập tên miền Amazon; ví dụ chính thức sử dụng `com`.
`department`	Bí danh phòng ban tùy chọn, tương ứng với tham số truy vấn `i` của Amazon.
`zip_code`	Mã bưu chính cho thông tin giao hàng.

Phản hồi được công bố có keyword, page, result, total_results_count, và url. Các mục sản phẩm xuất hiện dưới result.organic. Ví dụ phản hồi dành cho một truy vấn và trang khác với ví dụ yêu cầu, vì vậy nên dùng nó để hiểu các trường thay vì dự đoán kết quả chính xác.

Hướng dẫn tham số Amazon chỉ định các giá trị page dạng số nguyên, và ví dụ yêu cầu sử dụng 1; schema thao tác được tạo ra hiện gắn nhãn page là một chuỗi. Hướng dẫn này tuân theo hướng dẫn tham số và ví dụ yêu cầu.

Tài liệu tham khảo Keyword search API

Rufus

Đặt type thành rufus. Cả keywords và domain đều bắt buộc theo schema thao tác. Sử dụng một tên miền Amazon đầy đủ, chẳng hạn www.amazon.es, thay vì định dạng com được dùng trong ví dụ Tìm kiếm theo từ khóa.

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": "rufus",
    "keywords": "macbook",
    "domain": "www.amazon.es"
  }
}'

Phản hồi được công bố chứa:

Trường	Nội dung hiển thị trong ví dụ API
`html`	Nội dung thô chứa các bản ghi sự kiện và các đoạn HTML.
`metadata`	Bao gồm `type` và `rawUrl`.
`result.user_query`	Văn bản truy vấn.
`result.products`	Các mục sản phẩm được trả về cho truy vấn.
`result.related_questions`	Các câu hỏi liên quan.

Schema thao tác cũng liệt kê is_sse_data, is_get_question, và asin, nhưng không giải thích hành vi của chúng. Hãy bắt đầu với yêu cầu đã được ghi trong tài liệu ở trên.

Tài liệu tham khảo Rufus API

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 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 Results and 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à phản hồi dữ liệu thành công. Kiểm tra mục tiêu và các đầu vào yêu cầu trước khi thử lại.

Tài liệu tham khảo tham số

Sử dụng Amazon API Parameters để biết các bí danh phòng ban và các đầu vào khác được ghi trong tài liệu. Phân tích kết quả cho type đã chọn; Product, Keyword search, Seller, và Rufus không dùng chung một bố cục trường duy nhất.

Bắt đầu nhanh Giới thiệu