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/jsonThay thế 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
| Thao tác | input.type | Đầu vào được sử dụng bên dưới |
|---|---|---|
| Product | product | url, zip_code |
| Seller | seller | url, zip_code |
| Keyword search | keywords | keywords, page, domain, zip_code |
| Rufus | rufus | keywords, domain |
Product
Cung cấp URL sản phẩm Amazon. Schema Product yêu cầu url; zip_code cung cấp thông tin 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 trả về bao gồm asin, title, availability, final_price, rating, reviews_count, images và variations. Xem Quickstart để biết ví dụ phản hồi rút gọn.
Tài liệu tham khảo API Product
Seller
Cung cấp 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 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 mà không có schema hoặc 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.
Keyword search
Cung cấp văn bản tìm kiếm trong keywords. Sử dụng page để chọn trang kết quả tìm kiếm. Ví dụ bên dưới tuân theo giá trị trang số được tài liệu hóa và sử dụng domain: "com" cho Amazon.com; nó bỏ qua bộ lọc danh mục 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 | Mục đích sử 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 | Cài đặt miền Amazon; ví dụ chính thức sử dụng com. |
department | Bí danh danh mục 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 trả về 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ên được dùng để 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 giá trị page là số nguyên và ví dụ yêu cầu sử dụng 1; schema thao tác được tạo hiện đang gắn nhãn page là 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 API Keyword search
Rufus
Đặt type thành rufus. Cả keywords và domain đều bắt buộc theo schema thao tác. Sử dụng miền Amazon đầy đủ, chẳng hạn như www.amazon.es, thay vì định dạng com được dùng trong ví dụ Keyword search.
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 trả về chứa:
| Trường | Nội dung hiển thị trong ví dụ API |
|---|---|
html | Nội dung thô chứa 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. |
result.sources | Nguồn dữ liệu, trường này có thể không được trả về trong mọi phản hồi. Tính khả dụng của nó phụ thuộc vào sản phẩm và lời nhắc. |
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 tài liệu hóa ở trên.
Xử lý kết quả tác vụ
Phản hồi HTTP 200 chứa kết quả đã hoàn thành. 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 thế YOUR_TASK_ID bằng ID được trả về bởi yêu cầu của bạn. Tham khảo Results and Polling để biết khoảng thời gian polling và giới hạn thử lại.
Kiểm tra cả phần thân lỗi và mã trạng thái HTTP. Phản hồi 400 có thể bao gồm code: 20500 và message: "scraping failed"; đây 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 cho các bí danh danh mục và các đầu vào được tài liệu hóa khác. Phân tích kết quả cho type đã chọn; Product, Keyword search, Seller và Rufus không chia sẻ một bố cục trường duy nhất.