API de Amazon

La API de Amazon te permite buscar productos y obtener informacion detallada de productos por ASIN. Ambos endpoints soportan segmentacion multi-region, localizacion de moneda y emulacion de dispositivo.

Endpoints

Endpoint	Descripcion
`POST /api/v1/amazon/search`	Buscar productos de Amazon con ordenamiento, paginacion y filtros de categoria
`POST /api/v1/amazon/product`	Obtener informacion detallada de un producto por ASIN

Autenticacion

Cabecera	Valor	Requerido
`Authorization`	`Bearer YOUR_API_KEY`	Si
`Content-Type`	`application/json`	Si

Busqueda de Productos

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Busca productos en Amazon y obtiene resultados estructurados incluyendo precios, calificaciones y detalles del producto.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. Consulta de busqueda (1-500 caracteres).
`domain`	`string`	`com`	Sufijo de dominio de Amazon (ej. `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Orden de clasificacion. Uno de: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Numero de pagina inicial (indexado desde 1).
`pages`	`integer`	`1`	Numero de paginas a devolver.
`category_id`	`string`	--	ID de categoria/departamento de Amazon para filtrar resultados.
`merchant_id`	`string`	--	Filtrar por un vendedor especifico de Amazon.
`country`	`string`	--	Codigo de pais para localizacion.
`language`	`string`	--	Codigo de idioma para los resultados.
`currency`	`string`	--	Codigo de moneda ISO 4217 (ej. `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codigo postal para precios y disponibilidad localizados.
`autoselect_variant`	`boolean`	--	Seleccionar automaticamente la variante de producto predeterminada.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

Ejemplo de Respuesta

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

Detalles del Producto

Bash

POST https://api.scavio.dev/api/v1/amazon/product

Obtiene informacion detallada de un producto especifico de Amazon por su ASIN. Devuelve precios, descripcion, especificaciones, imagenes, calificaciones e informacion del vendedor.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. ASIN de Amazon (ej. `B09XS7JWHH`).
`domain`	`string`	`com`	Sufijo de dominio de Amazon (ej. `com`, `co.uk`, `de`).
`country`	`string`	--	Codigo de pais para localizacion.
`language`	`string`	--	Codigo de idioma para los resultados.
`currency`	`string`	--	Codigo de moneda ISO 4217 (ej. `USD`, `EUR`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codigo postal para precios localizados.
`autoselect_variant`	`boolean`	--	Seleccionar automaticamente la variante de producto predeterminada.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

Ejemplo de Respuesta

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

Dominios Soportados

Usa el parametro domain para apuntar a un marketplace especifico de Amazon:

Dominio	Marketplace
`com`	Estados Unidos
`co.uk`	Reino Unido
`de`	Alemania
`fr`	Francia
`co.jp`	Japon
`ca`	Canada
`it`	Italia
`es`	Espana
`in`	India
`com.au`	Australia
`com.br`	Brasil
`com.mx`	Mexico

Formato de Respuesta

Ambos endpoints devuelven un envoltorio de respuesta consistente:

Campo	Tipo	Descripcion
`data`	`object \| null`	El payload de la respuesta. `null` si la solicitud fallo en el upstream. La busqueda devuelve `{page, products, html}`; el producto devuelve el objeto del producto directamente.
`response_time`	`number`	Tiempo de respuesta del servidor en milisegundos
`credits_used`	`number`	Numero de creditos consumidos
`credits_remaining`	`number`	Creditos restantes en tu periodo de facturacion actual

Respuestas de Error

Estado	Descripcion
`401`	No autorizado -- clave API faltante o invalida
`429`	Limite de tasa o uso excedido para tu plan
`502`	Error del upstream -- reintentar despues de un breve retraso
`503`	Upstream no disponible -- reintentar mas tarde

Consulta Errores para la referencia completa de errores y mejores practicas de reintento.

Relacionados

Inicio Rapido -- obtener tu clave API y hacer tu primera solicitud
API de Google Search -- buscar en Google con datos SERP estructurados
YouTube API -- buscar videos y extraer metadatos
Limites de Tasa -- limites por nivel de plan

API de Amazon

Endpoints

Endpoint	Descripcion
`POST /api/v1/amazon/search`	Buscar productos de Amazon con ordenamiento, paginacion y filtros de categoria
`POST /api/v1/amazon/product`	Obtener informacion detallada de un producto por ASIN

Autenticacion

Cabecera	Valor	Requerido
`Authorization`	`Bearer YOUR_API_KEY`	Si
`Content-Type`	`application/json`	Si

Busqueda de Productos

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Busca productos en Amazon y obtiene resultados estructurados incluyendo precios, calificaciones y detalles del producto.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. Consulta de busqueda (1-500 caracteres).
`domain`	`string`	`com`	Sufijo de dominio de Amazon (ej. `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Orden de clasificacion. Uno de: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Numero de pagina inicial (indexado desde 1).
`pages`	`integer`	`1`	Numero de paginas a devolver.
`category_id`	`string`	--	ID de categoria/departamento de Amazon para filtrar resultados.
`merchant_id`	`string`	--	Filtrar por un vendedor especifico de Amazon.
`country`	`string`	--	Codigo de pais para localizacion.
`language`	`string`	--	Codigo de idioma para los resultados.
`currency`	`string`	--	Codigo de moneda ISO 4217 (ej. `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codigo postal para precios y disponibilidad localizados.
`autoselect_variant`	`boolean`	--	Seleccionar automaticamente la variante de producto predeterminada.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

Ejemplo de Respuesta

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

Detalles del Producto

Bash

POST https://api.scavio.dev/api/v1/amazon/product

Obtiene informacion detallada de un producto especifico de Amazon por su ASIN. Devuelve precios, descripcion, especificaciones, imagenes, calificaciones e informacion del vendedor.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. ASIN de Amazon (ej. `B09XS7JWHH`).
`domain`	`string`	`com`	Sufijo de dominio de Amazon (ej. `com`, `co.uk`, `de`).
`country`	`string`	--	Codigo de pais para localizacion.
`language`	`string`	--	Codigo de idioma para los resultados.
`currency`	`string`	--	Codigo de moneda ISO 4217 (ej. `USD`, `EUR`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codigo postal para precios localizados.
`autoselect_variant`	`boolean`	--	Seleccionar automaticamente la variante de producto predeterminada.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

Ejemplo de Respuesta

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

Dominios Soportados

Usa el parametro domain para apuntar a un marketplace especifico de Amazon:

Dominio	Marketplace
`com`	Estados Unidos
`co.uk`	Reino Unido
`de`	Alemania
`fr`	Francia
`co.jp`	Japon
`ca`	Canada
`it`	Italia
`es`	Espana
`in`	India
`com.au`	Australia
`com.br`	Brasil
`com.mx`	Mexico

Formato de Respuesta

Ambos endpoints devuelven un envoltorio de respuesta consistente:

Campo	Tipo	Descripcion
`data`	`object \| null`	El payload de la respuesta. `null` si la solicitud fallo en el upstream. La busqueda devuelve `{page, products, html}`; el producto devuelve el objeto del producto directamente.
`response_time`	`number`	Tiempo de respuesta del servidor en milisegundos
`credits_used`	`number`	Numero de creditos consumidos
`credits_remaining`	`number`	Creditos restantes en tu periodo de facturacion actual

Respuestas de Error

Estado	Descripcion
`401`	No autorizado -- clave API faltante o invalida
`429`	Limite de tasa o uso excedido para tu plan
`502`	Error del upstream -- reintentar despues de un breve retraso
`503`	Upstream no disponible -- reintentar mas tarde

Consulta Errores para la referencia completa de errores y mejores practicas de reintento.

Relacionados

Inicio Rapido -- obtener tu clave API y hacer tu primera solicitud
API de Google Search -- buscar en Google con datos SERP estructurados
YouTube API -- buscar videos y extraer metadatos
Limites de Tasa -- limites por nivel de plan