Inicio rápido de Amazon Scraper

Solicite un producto de Amazon con cURL y lea su resultado estructurado. Este tutorial utiliza el ejemplo de solicitud de la referencia de la API de Product.

Antes de comenzar

Necesita una cuenta de Scrapeless, una clave de API válida y cURL. Obtenga su clave desde el panel de control de Scrapeless.

El ejemplo utiliza una URL de producto de la referencia de la API. Puede reemplazarla con la URL del producto de Amazon que desee recuperar. La disponibilidad de listados y los valores devueltos pueden cambiar.

1. Envíe la solicitud

Reemplace YOUR_API_KEY por su 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": "product",
    "url": "https://www.amazon.com/dp/B0BQXHK363",
    "zip_code": ""
  }
}'

El cuerpo selecciona el Actor de Amazon, establece type en product y proporciona la URL del producto url. El campo zip_code vacío coincide con el ejemplo oficial; proporcione un código postal cuando necesite información de entrega para esa ubicación.

2. Lea un resultado completado

El estado HTTP 200 indica finalización. Lo siguiente es un subconjunto de campos del ejemplo de respuesta Product publicado, no una captura reciente:

{
  "asin": "B0BQXHK363",
  "availability": "In Stock",
  "final_price": "$44.99",
  "rating": "4.0",
  "reviews_count": "115"
}

Los precios, calificaciones y conteos de reseñas en este ejemplo son cadenas de texto. Mantenga los tipos devueltos al leer la carga útil y conviértalos explícitamente si su aplicación necesita valores numéricos. Otros campos en el ejemplo completo incluyen title, images y variations.

3. Recupere una tarea que aún está procesándose

Una respuesta HTTP con estado 201 devuelve un ID de tarea. La referencia de la API muestra:

{
  "message": "task in progress",
  "taskId": "a8af123c-0f81-477d-a2e7-c57ad18fe54a"
}

Use el ID de su propia respuesta, no el ID del ejemplo, en esta solicitud:

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

Si la tarea aún está procesándose, continúe según la guía de Resultados y sondeo (polling). Utilice una política de reintento acotada en lugar de enviar repetidamente la misma solicitud de producto.

Si la solicitud falla

Inspeccione tanto el estado HTTP como el cuerpo de la respuesta. La referencia de Product incluye un ejemplo con 400 , code: 20500 y message: "scraping failed". Verifique la clave, la URL del producto y la entrada JSON. Siga la guía compartida de sondeo para límites de tasa y errores del servidor.

Próximos pasos

Continúe con los endpoints para solicitudes de vendedor, búsqueda por palabra clave y Rufus. Revise la referencia de la API de Product para el ejemplo completo publicado.

Introducción Endpoints