Endpoints de Amazon Scraper
Utiliza el actor scraper.amazon para cada operación en esta página. Selecciona la operación con input.type y proporciona sus entradas correspondientes.
Solicitud y autenticación
POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/jsonReemplaza YOUR_API_KEY con tu clave de API de Scrapeless. Envía un único objeto JSON que contenga actor e input.
Elige una operación
| Operación | input.type | Entradas utilizadas a continuación |
|---|---|---|
| Producto | product | url, zip_code |
| Vendedor | seller | url, zip_code |
| Búsqueda por palabras clave | keywords | keywords, page, domain, zip_code |
| Rufus | rufus | keywords, domain |
Producto
Proporciona una URL de producto de Amazon. El esquema de Producto requiere url; zip_code proporciona información sobre la ubicación de entrega.
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": ""
}
}'La respuesta publicada incluye asin, title, availability, final_price, rating, reviews_count, images y variations. Consulta Inicio rápido para ver un ejemplo de respuesta abreviado.
Referencia de la API de Producto
Vendedor
Proporciona una URL de página de vendedor. Incluye zip_code: el esquema de Vendedor lo marca como obligatorio y su ejemplo de solicitud utiliza una cadena vací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": "seller",
"url": "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
"zip_code": ""
}
}'La referencia de Vendedor define la respuesta exitosa como un objeto JSON sin un esquema o ejemplo a nivel de campo. Inspecciona la carga útil devuelta antes de asignar los campos del vendedor en tu aplicación.
Referencia de la API de Vendedor
Búsqueda por palabras clave
Proporciona el texto de búsqueda en keywords. Usa page para seleccionar una página de resultados de búsqueda. El siguiente ejemplo sigue el valor numérico de página documentado y utiliza domain: "com" para Amazon.com; omite el filtro de departamento opcional.
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": ""
}
}'| Entrada | Uso |
|---|---|
keywords | Palabras clave de búsqueda; obligatorio según el esquema de la operación. |
page | Número de página de resultados de búsqueda. |
domain | Configuración del dominio de Amazon; el ejemplo oficial utiliza com. |
department | Alias de departamento opcional, correspondiente al parámetro de consulta i de Amazon. |
zip_code | Código postal para información de entrega. |
La respuesta publicada contiene keyword, page, result, total_results_count y url. Las entradas de productos aparecen bajo result.organic. El ejemplo de respuesta corresponde a una consulta y página diferentes al ejemplo de solicitud, por lo que debe usarse para comprender los campos en lugar de predecir resultados exactos.
La guía de parámetros de Amazon especifica valores enteros para page, y el ejemplo de solicitud utiliza 1; el esquema de operación generado actualmente etiqueta page como una cadena. Esta guía sigue la guía de parámetros y el ejemplo de solicitud.
Referencia de la API de búsqueda por palabras clave
Rufus
Establece type en rufus. Tanto keywords como domain son obligatorios según el esquema de la operación. Usa un dominio completo de Amazon, como www.amazon.es, en lugar del formato com utilizado en el ejemplo de Búsqueda por palabras clave.
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"
}
}'La respuesta publicada contiene:
| Campo | Contenido mostrado en el ejemplo de la API |
|---|---|
html | Contenido sin procesar que contiene registros de eventos y fragmentos HTML. |
metadata | Incluye type y rawUrl. |
result.user_query | Texto de la consulta. |
result.products | Entradas de productos devueltas para la consulta. |
result.related_questions | Preguntas relacionadas. |
result.sources | Fuente de datos; el campo puede no devolverse en cada respuesta. Su disponibilidad depende del producto y del prompt. |
El esquema de la operación también enumera is_sse_data, is_get_question y asin, pero no explica su comportamiento. Comienza con la solicitud documentada anteriormente.
Gestionar resultados de tareas
Una respuesta HTTP 200 contiene el resultado completado. Una respuesta HTTP 201 significa que el procesamiento aún está en curso; guarda su taskId y recupera esa tarea con:
curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
--header 'x-api-token: YOUR_API_KEY'Reemplaza YOUR_TASK_ID con el ID devuelto por tu solicitud. Consulta Resultados y sondeo para conocer los intervalos de sondeo y los límites de reintentos.
Inspecciona los cuerpos de error así como los códigos de estado HTTP. Una respuesta 400 puede incluir code: 20500 y message: "scraping failed"; no es una respuesta de datos exitosa. Verifica el objetivo y las entradas de la solicitud antes de reintentar.
Referencia de parámetros
Utiliza Parámetros de la API de Amazon para los alias de departamento y otras entradas documentadas. Analiza los resultados según el type seleccionado; Producto, Búsqueda por palabras clave, Vendedor y Rufus no comparten una única estructura de campos.