Amazon API

A Amazon API permite pesquisar produtos e obter informações detalhadas do produto pelo ASIN. Ambos os endpoints suportam segmentação multirregional, localização de moeda e emulação de dispositivo.

Endpoints

Endpoint	Descrição
`POST /api/v1/amazon/search`	Pesquisar produtos da Amazon com classificação, paginação e filtros de categoria
`POST /api/v1/amazon/product`	Obter informações detalhadas do produto pelo ASIN

Autenticação

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer SUA_CHAVE_API`	Sim
`Content-Type`	`application/json`	Sim

Pesquisa de Produtos

Bash

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

Pesquise produtos da Amazon e obtenha resultados estruturados incluindo preços, avaliações e detalhes do produto.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. Termo de pesquisa (1-500 caracteres).
`domain`	`string`	`com`	Sufixo do domínio da Amazon (ex.: `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Ordem de classificação. Uma de: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Número da página inicial (baseado em 1).
`pages`	`integer`	`1`	Número de páginas a retornar.
`category_id`	`string`	--	ID da categoria/departamento da Amazon para restringir resultados.
`merchant_id`	`string`	--	Filtrar por um vendedor específico da Amazon.
`country`	`string`	--	Código do país para localização.
`language`	`string`	--	Código do idioma para os resultados.
`currency`	`string`	--	Código de moeda ISO 4217 (ex.: `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uma de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Código postal/CEP para preços e disponibilidade localizados.
`autoselect_variant`	`boolean`	--	Selecionar automaticamente a variante padrão do produto.

Exemplo

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
  }'

Exemplo de Resposta

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
}

Detalhes do Produto

Bash

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

Obtenha informações detalhadas de um produto específico da Amazon pelo seu ASIN. Retorna preço, descrição, especificações, imagens, avaliações e informações do vendedor.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. ASIN da Amazon (ex.: `B09XS7JWHH`).
`domain`	`string`	`com`	Sufixo do domínio da Amazon (ex.: `com`, `co.uk`, `de`).
`country`	`string`	--	Código do país para localização.
`language`	`string`	--	Código do idioma para os resultados.
`currency`	`string`	--	Código de moeda ISO 4217 (ex.: `USD`, `EUR`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uma de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Código postal/CEP para preços localizados.
`autoselect_variant`	`boolean`	--	Selecionar automaticamente a variante padrão do produto.

Exemplo

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"}'

Exemplo de Resposta

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
}

Domínios Suportados

Use o parâmetro domain para segmentar um marketplace específico da Amazon:

Domínio	Marketplace
`com`	Estados Unidos
`co.uk`	Reino Unido
`de`	Alemanha
`fr`	França
`co.jp`	Japão
`ca`	Canadá
`it`	Itália
`es`	Espanha
`in`	Índia
`com.au`	Austrália
`com.br`	Brasil
`com.mx`	México

Formato da Resposta

Ambos os endpoints retornam um wrapper de resposta consistente:

Campo	Tipo	Descrição
`data`	`object \| null`	O payload da resposta. `null` se a requisição falhou upstream. A pesquisa retorna `{page, products, html}`; o produto retorna o objeto do produto diretamente.
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Respostas de Erro

Status	Descrição
`401`	Não autorizado -- chave de API ausente ou inválida
`429`	Limite de taxa ou uso excedido para seu plano
`502`	Erro upstream -- tente novamente após um breve intervalo
`503`	Upstream indisponível -- tente novamente mais tarde

Veja Erros para a referência completa de erros e práticas recomendadas de repetição.

Relacionados

Início Rápido -- obtenha sua chave de API e faça sua primeira requisição
Google Search API -- pesquise no Google com dados SERP estruturados
YouTube API -- pesquise vídeos e extraia metadados
Limites de Taxa -- limites por nível de plano

Amazon API

Endpoints

Endpoint	Descrição
`POST /api/v1/amazon/search`	Pesquisar produtos da Amazon com classificação, paginação e filtros de categoria
`POST /api/v1/amazon/product`	Obter informações detalhadas do produto pelo ASIN

Autenticação

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer SUA_CHAVE_API`	Sim
`Content-Type`	`application/json`	Sim

Pesquisa de Produtos

Bash

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

Pesquise produtos da Amazon e obtenha resultados estruturados incluindo preços, avaliações e detalhes do produto.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. Termo de pesquisa (1-500 caracteres).
`domain`	`string`	`com`	Sufixo do domínio da Amazon (ex.: `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Ordem de classificação. Uma de: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Número da página inicial (baseado em 1).
`pages`	`integer`	`1`	Número de páginas a retornar.
`category_id`	`string`	--	ID da categoria/departamento da Amazon para restringir resultados.
`merchant_id`	`string`	--	Filtrar por um vendedor específico da Amazon.
`country`	`string`	--	Código do país para localização.
`language`	`string`	--	Código do idioma para os resultados.
`currency`	`string`	--	Código de moeda ISO 4217 (ex.: `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uma de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Código postal/CEP para preços e disponibilidade localizados.
`autoselect_variant`	`boolean`	--	Selecionar automaticamente a variante padrão do produto.

Exemplo

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
  }'

Exemplo de Resposta

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
}

Detalhes do Produto

Bash

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

Obtenha informações detalhadas de um produto específico da Amazon pelo seu ASIN. Retorna preço, descrição, especificações, imagens, avaliações e informações do vendedor.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. ASIN da Amazon (ex.: `B09XS7JWHH`).
`domain`	`string`	`com`	Sufixo do domínio da Amazon (ex.: `com`, `co.uk`, `de`).
`country`	`string`	--	Código do país para localização.
`language`	`string`	--	Código do idioma para os resultados.
`currency`	`string`	--	Código de moeda ISO 4217 (ex.: `USD`, `EUR`).
`device`	`string`	`desktop`	Tipo de dispositivo. Uma de: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Código postal/CEP para preços localizados.
`autoselect_variant`	`boolean`	--	Selecionar automaticamente a variante padrão do produto.

Exemplo

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"}'

Exemplo de Resposta

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
}

Domínios Suportados

Use o parâmetro domain para segmentar um marketplace específico da Amazon:

Domínio	Marketplace
`com`	Estados Unidos
`co.uk`	Reino Unido
`de`	Alemanha
`fr`	França
`co.jp`	Japão
`ca`	Canadá
`it`	Itália
`es`	Espanha
`in`	Índia
`com.au`	Austrália
`com.br`	Brasil
`com.mx`	México

Formato da Resposta

Ambos os endpoints retornam um wrapper de resposta consistente:

Campo	Tipo	Descrição
`data`	`object \| null`	O payload da resposta. `null` se a requisição falhou upstream. A pesquisa retorna `{page, products, html}`; o produto retorna o objeto do produto diretamente.
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Respostas de Erro

Status	Descrição
`401`	Não autorizado -- chave de API ausente ou inválida
`429`	Limite de taxa ou uso excedido para seu plano
`502`	Erro upstream -- tente novamente após um breve intervalo
`503`	Upstream indisponível -- tente novamente mais tarde

Veja Erros para a referência completa de erros e práticas recomendadas de repetição.

Relacionados

Início Rápido -- obtenha sua chave de API e faça sua primeira requisição
Google Search API -- pesquise no Google com dados SERP estruturados
YouTube API -- pesquise vídeos e extraia metadados
Limites de Taxa -- limites por nível de plano