Comercio electrónicoDisponible

Amazon Product Search

Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.

Consulta cada endpoint con ejemplos de solicitud, parámetros y su precio por solicitud. Una sola clave API los llama todos; se aplican límites de cuenta.

Referencia de API Abrir en Playground

En resumen

Endpoint: POST https://api.serpbase.dev/amazon/search
Precio: 2 créditos / solicitud
Autenticación: X-API-Key
Tipo de resultado: schemas.source_data

Endpoint y reglas de facturación

POSThttps://api.serpbase.dev/amazon/search

Costo por solicitud

2 créditos / solicitud

Cada solicitud usa el precio fijo del catálogo, no una tarifa por página. Web Crawl y User Agent cuestan actualmente 1 crédito por solicitud cada uno; User Agent no es gratuito. La ausencia real confirmada por la fuente y la identidad del recurso se cobra. no_results, HTTP 404 o la falta de hydration/datos analizados por sí solos no prueban ausencia. Los fallos ejecutados pueden consumir créditos; no se garantiza el reembolso de todos los fallos. credits_charged informa del cargo real: 0 indica cero; null o ausencia significa desconocido. charge_status UNKNOWN sigue siendo desconocido incluso con un valor numérico. Revisa los registros y contacta con soporte con request_id; no supongas un reembolso ni reintentes a ciegas.

Ejemplos de parámetros

Los ejemplos no son una lista completa ni reglas obligatorias. Se validan campos conocidos y se permiten parámetros adicionales.

Ejemplos de parámetros
Parámetro	Tipo de ejemplo	Valor de ejemplo
domain	string	"amazon.com"
q	string	"wireless headphones"

JSON

{
  "domain": "amazon.com",
  "q": "wireless headphones"
}

Los ejemplos no son una lista completa ni reglas obligatorias. Se validan campos conocidos y se permiten parámetros adicionales.
Alias	Parámetro	Tipo
amazon_domain	domain	string
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
type	search_type	string

Dispositivos: desktop; predeterminado: desktop.

Ejemplos de solicitudes

cURL

curl -X POST 'https://api.serpbase.dev/amazon/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"domain":"amazon.com","q":"wireless headphones"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/amazon/search", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"domain\":\"amazon.com\",\"q\":\"wireless headphones\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Respuesta y resultado de la API

Las respuestas son JSON. HTTP 200 no prueba el éxito: revisa status y error. Los campos dependen del contrato y los datos de origen.

Ver documentación de respuesta

Preguntas frecuentes

¿Cuánto cuesta la API de Amazon Product Search?

Cada solicitud cuesta 2 créditos. Los créditos se compran en paquetes prepago o con el plan mensual, y las cuentas nuevas empiezan con créditos gratis.

¿Cómo llamo a la API de Amazon Product Search?

Envía una solicitud POST a https://api.serpbase.dev/amazon/search con tu clave API en la cabecera X-API-Key. La respuesta es JSON; revisa status (0 significa éxito).

¿Qué dispositivos admite?

Dispositivos admitidos: desktop. El predeterminado es desktop.

¿La API de Amazon Product Search ya está disponible?

Sí. Cualquier clave API activa puede llamarla.