Documentación de Scraping API

URL Base

https://api.asinspotlight.com/v1

Autenticación

Todas las solicitudes requieren una clave API en el encabezado x-api-key:

curl -H "x-api-key: YOUR_API_KEY" "https://api.asinspotlight.com/v1/product?asin=B0B3ZD8QXJ"

Endpoints

GET /v1/product

Obtener detalles de un producto por ASIN.

Parámetros

Ejemplo

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.asinspotlight.com/v1/product?asin=B0B3ZD8QXJ&marketplace=us"

Respuesta

{
  "success": true,
  "page_type": "product",
  "data": {
    "asin": "B0B3ZD8QXJ",
    "title": "Product Title",
    "buybox": true,
    "bb_price": 29.99,
    "rating": 4.5,
    "reviews": 1234,
    "bsr": 5678,
    "in_stock": true,
    "is_prime": true,
    "brand": { "name": "BrandName", "url": "/stores/BrandName" },
    "category": { "name": "Electronics", "url": "/b?node=123" },
    "image_url": "https://m.media-amazon.com/images/I/...",
    "sellers_all": 5,
    "bought_past_month": 1000
  },
  "meta": {
    "marketplace": "us",
    "timing_ms": 2340,
    "request_url": "https://www.amazon.com/dp/B0B3ZD8QXJ",
    "timestamp": "2026-04-03T12:00:00.000Z",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

GET /v1/offers

Obtener ofertas de vendedores para un producto.

Parámetros

Ejemplo

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.asinspotlight.com/v1/offers?asin=B0B3ZD8QXJ&marketplace=us"

Respuesta

{
  "success": true,
  "page_type": "offers",
  "data": {
    "sold_by_amazon": true,
    "fba_count": 3,
    "fbm_count": 2,
    "product_sellers_info": [
      {
        "name": "Amazon.com",
        "price": 29.99,
        "shipping_price": 0,
        "is_fba": true,
        "is_amazon": true,
        "stock_qty": 100,
        "rating_percent": 95,
        "reviews_count": 50000
      }
    ]
  },
  "meta": { "..." : "..." }
}

GET /v1/search

Buscar productos por palabra clave.

Parámetros

Ejemplo

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.asinspotlight.com/v1/search?keyword=wireless+headphones&marketplace=us"

Respuesta

{
  "success": true,
  "page_type": "search",
  "data": {
    "title": "wireless headphones",
    "current_page": 1,
    "last_page_number": 20,
    "total_results_count": 10000,
    "shallow_parts": [
      {
        "asin": "B0CQXMXJC5",
        "title": "Soundcore Q20i Headphones",
        "price": 39.99,
        "rating": 4.6,
        "reviews": 58800,
        "bought_past_month": 20000,
        "in_stock": true,
        "image_url": "https://m.media-amazon.com/images/I/..."
      }
    ]
  },
  "meta": { "..." : "..." }
}

GET /v1/reviews

Obtener reseñas de un producto.

Parámetros

Ejemplo

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.asinspotlight.com/v1/reviews?asin=B0B3ZD8QXJ&marketplace=us"

Respuesta

{
  "success": true,
  "page_type": "reviews",
  "data": {
    "count_ratings_with_reviews": 1234,
    "page_number": 1,
    "reviews": [
      {
        "review_id": "R1ABC2DEF3GH",
        "review_date": "April 1, 2026",
        "review_stars": 5,
        "review_title": "Great product!",
        "review_body": "Exactly what I needed...",
        "is_purchase_verified": true,
        "number_of_found_helpful": 42,
        "reviewer_name": "John D."
      }
    ]
  },
  "meta": { "..." : "..." }
}

POST /v1/scrape

Extraer datos de cualquier URL de Amazon. El tipo de página se detecta automáticamente.

Cuerpo de la solicitud (JSON)

Ejemplo

curl -X POST -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.amazon.com/s?k=laptop+stand", "marketplace": "us"}' \
  "https://api.asinspotlight.com/v1/scrape"

Marketplaces compatibles

Respuestas de error

Todos los errores siguen un formato consistente:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Descripción legible"
  }
}