Amazon Search Autocomplete

Obtenha sugestões da Amazon por prefixo, não detalhes nem histórico de preços.

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/autocomplete
Preço: 1 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/autocomplete

Custo por solicitação

1 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
prefix	string	"laptop"

JSON

{
  "prefix": "laptop"
}

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
mid	marketplace_id	string
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/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"prefix":"laptop"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/amazon/autocomplete", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"prefix\":\"laptop\"}"
});
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 Search Autocomplete?

Cada requisição custa 1 crédito. 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 Search Autocomplete?

Envie uma requisição POST para https://api.serpbase.dev/amazon/autocomplete 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 Search Autocomplete já está disponível?

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