Comércio eletrônicoDisponível

Amazon Product Search

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

Consulte cada endpoint com exemplos de requisição, parâmetros e o preço por requisição. Uma única chave de API chama todos; aplicam-se limites da conta.

Referência da API Abrir no Playground

Resumo

Endpoint: POST https://api.serpbase.dev/amazon/search
Preço: 2 créditos / solicitação
Autenticação: X-API-Key
Tipo de resultado: schemas.source_data

Endpoint e regras de cobrança

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

Custo por solicitação

2 créditos / solicitação

Cada solicitação usa o preço fixo do catálogo, não uma tarifa por página. Web Crawl e User Agent custam atualmente 1 crédito por solicitação cada; User Agent não é gratuito. A ausência real confirmada pela fonte e identidade do recurso é cobrada. no_results, HTTP 404 ou falta de hydration/dados analisados, isoladamente, não provam ausência. Falhas executadas podem consumir créditos; não há garantia de reembolso de todas as falhas. credits_charged informa a cobrança real: 0 indica zero; null ou campo ausente significa desconhecido. charge_status UNKNOWN permanece desconhecido mesmo com valor numérico. Confira os registros e contate o suporte com request_id; não presuma reembolso nem repita solicitações às cegas.

Exemplos de parâmetros

Os exemplos não são uma lista completa nem regras de obrigatoriedade. Campos conhecidos são validados e parâmetros adicionais são permitidos.

Exemplos de parâmetros
Parâmetro	Tipo do exemplo	Valor do exemplo
domain	string	"amazon.com"
q	string	"wireless headphones"

JSON

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

Os exemplos não são uma lista completa nem regras de obrigatoriedade. Campos conhecidos são validados e parâmetros adicionais são permitidos.
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; padrão: desktop.

Exemplos de solicitações

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);

Resposta e resultado da API

As respostas são JSON. HTTP 200 não prova sucesso: verifique status e error. Os campos dependem do contrato e dos dados de origem.

Ver documentação da resposta

Perguntas frequentes

Quanto custa a API de Amazon Product Search?

Cada requisição custa 2 créditos. Os créditos vêm de pacotes pré-pagos ou do plano mensal, e contas novas começam com créditos grátis.

Como chamo a API de Amazon Product Search?

Envie uma requisição POST para https://api.serpbase.dev/amazon/search com sua chave de API no cabeçalho X-API-Key. A resposta é JSON; verifique status (0 significa sucesso).

Quais dispositivos são suportados?

Dispositivos suportados: desktop. O padrão é desktop.

A API de Amazon Product Search já está disponível?

Sim. Qualquer chave de API ativa pode chamá-la.