API para Amazon

API para Amazon: Mais vendidos

Liste os produtos mais bem ranqueados de qualquer categoria de Best Sellers da Amazon (posição, título, preço e avaliação) em uma única requisição normalizada.

POST/v1/run/amazon.bestsellers
Disponibilidade
100,00%
30d · 17 chamadas
Requisições
17
30d · semanal, últimas 12 sem.
Resposta
8,0s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `offersCount` ou `categoryName`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um produto que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "items": [
      {
        "asin": "example",
        "categoryName": "Example title",
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "offersCount": 12500,
        "price": 19.99,
        "rank": 1,
        "rating": 4.6,
        "reviewsCount": 12500,
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface AmazonBestsellersResponse {
  data: {
    items: {
      asin: string;
      categoryName?: string | null;
      currency?: string;
      image?: string;
      offersCount?: number | null;
      price?: number;
      rank?: number;
      rating?: number;
      reviewsCount?: number;
      title: string;
      url: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/amazon.bestsellers
curl -X POST https://api.getanyapi.com/v1/run/amazon.bestsellers \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"url":"https://www.amazon.com/gp/bestsellers/electronics"}'
CampoTipoValor de exemplo
Corpo da requisição
urlstring"https://www.amazon.com/gp/bestsellers/electronics"URL de categoria de Best Sellers da Amazon (ex.: https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics).
limitinteger3Número máximo de resultados a retornar (1-20, padrão 20).
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `offersCount` ou `categoryName`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um produto que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Resposta
dataobjectBest-sellers wrapper, or null when the category returned nothing.
data.itemsobject[]Best-seller product records ordered by category rank. Populated whenever the provider has data for the entity.
data.items[].asinstringAmazon Standard Identification Number. Populated whenever the provider has data for the entity.
data.items[].categoryNamepode ser exigidostringBest Sellers category name the product ranks in, or null when the serving source does not publish it.
data.items[].currencystringPrice currency symbol or code, e.g. "$".
data.items[].imagestringPrimary product thumbnail image URL.
data.items[].offersCountpode ser exigidointegerNumber of available offers, or null when the serving source does not publish it.
data.items[].pricenumberListed price; 0 when no offer is available.
data.items[].rankintegerBest-seller rank within the category (1 = top).
data.items[].ratingnumberAverage star rating, 0-5; 0 when unrated.
data.items[].reviewsCountintegerNumber of customer reviews; 0 when none.
data.items[].titlestringProduct title. Populated whenever the provider has data for the entity.
data.items[].urlstringCanonical product detail page URL (tracking query params stripped). Populated whenever the provider has data for the entity.
foundbooleanTrue when the category returned at least one best-seller.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,0005
Preço /mil req.USDUS$ 0,50

Dúvidas frequentes

Sobre o endpoint Mais vendidos da API para Amazon

O endpoint Mais vendidos da AnyAPI para Amazon retorna dados de Amazon em JSON normalizado com uma chamada POST para /v1/run/amazon.bestsellers. Liste os produtos mais bem ranqueados de qualquer categoria de Best Sellers da Amazon (posição, título, preço e avaliação) em uma única requisição normalizada. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Mais vendidos da API para Amazon feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 8,0 segundos, em 17 chamadas medidas.

Custa a partir de US$ 0,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Liste os produtos mais bem ranqueados de qualquer categoria de Best Sellers da Amazon (posição, título, preço e avaliação) em uma única requisição normalizada. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Mais vendidos da API para Amazon feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 8,0 segundos, em 17 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de Amazon

ASINsa partir de US$ 3,85 /mil ASINsProdutoa partir de US$ 1,00 /mil req.Avaliaçõesa partir de US$ 1,00 /mil req.Buscara partir de US$ 0,50 /mil req.