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/json

Reemplaza 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óninput.typeEntradas utilizadas a continuación
Productoproducturl, zip_code
Vendedorsellerurl, zip_code
Búsqueda por palabras clavekeywordskeywords, page, domain, zip_code
Rufusrufuskeywords, 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": ""
  }
}'
EntradaUso
keywordsPalabras clave de búsqueda; obligatorio según el esquema de la operación.
pageNúmero de página de resultados de búsqueda.
domainConfiguración del dominio de Amazon; el ejemplo oficial utiliza com.
departmentAlias de departamento opcional, correspondiente al parámetro de consulta i de Amazon.
zip_codeCó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:

CampoContenido mostrado en el ejemplo de la API
htmlContenido sin procesar que contiene registros de eventos y fragmentos HTML.
metadataIncluye type y rawUrl.
result.user_queryTexto de la consulta.
result.productsEntradas de productos devueltas para la consulta.
result.related_questionsPreguntas relacionadas.
result.sourcesFuente 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.

Referencia de la API de Rufus

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.