Endpoints de Amazon Scraper

Utilice el actor scraper.amazon para cada operación en esta página. Seleccione la operación con input.type y proporcione las entradas correspondientes.

Solicitud y autenticación

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

Reemplace YOUR_API_KEY con su clave de API de Scrapeless. Envíe un objeto JSON que contenga actor y input.

Elija 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 palabra clave	`keywords`	`keywords`, `page`, `domain`, `zip_code`
Rufus	`rufus`	`keywords`, `domain`

Producto

Proporcione 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. Consulte Inicio rápido para ver un ejemplo de respuesta abreviada.

Referencia de la API de Producto

Vendedor

Proporcione una URL de la página del vendedor. Incluya 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 ni ejemplo a nivel de campo. Inspeccione la carga devuelta antes de mapear los campos del vendedor en su aplicación.

Referencia de la API del vendedor

Búsqueda por palabra clave

Proporcione el texto de búsqueda en keywords. Use page para seleccionar una página de resultados de búsqueda. El ejemplo siguiente sigue el valor numérico de página documentado y utiliza domain: "com" para Amazon.com; omite el filtro opcional de departamento.

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	Utilice
`keywords`	Palabras clave de búsqueda; requeridas por 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 tiene 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 del ejemplo de solicitud, por lo que debe usarse para comprender los campos, no para predecir resultados exactos.

La guía de parámetros de Amazon especifica valores enteros page , y el ejemplo de solicitud utiliza 1; actualmente, el esquema de operación generado etiqueta page como 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

Establezca type en rufus. Tanto keywords como domain son requeridos por el esquema de la operación. Utilice un dominio completo de Amazon, como www.amazon.es, en lugar del formato com usado 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 consulta.
`result.products`	Entradas de productos devueltas para la consulta.
`result.related_questions`	Preguntas relacionadas.

El esquema de operación también enumera is_sse_data, is_get_question y asin, pero no explica su comportamiento. Comience con la solicitud documentada anteriormente.

Referencia de la API Rufus

Manejar los resultados de la tarea

Una respuesta HTTP 200 contiene el resultado completado. Una respuesta HTTP 201 significa que el procesamiento aún está en curso; guarde su taskId y recupere esa tarea con:

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

Reemplace YOUR_TASK_ID con el ID devuelto por su solicitud. Siga las indicaciones de Resultados e interrupciones periódicas para conocer los intervalos de sondeo y los límites de reintento.

Revise también los cuerpos de error además de los códigos de estado HTTP. Una respuesta 400 puede incluir code: 20500 y message: "scraping failed"; no constituye una respuesta de datos exitosa. Verifique el destino y las entradas de la solicitud antes de reintentar.

Referencia de parámetros

Utilice los parámetros de la API de Amazon para los alias de departamento y otras entradas documentadas. Analice los resultados según el type seleccionado; Producto, Búsqueda por palabras clave, Vendedor y Rufus no comparten un único diseño de campo.

Inicio rápido Introducción