Navegação da documentação
Integrações

Conectar a Amazon

Gere as credenciais da Creators API da Amazon, pegue a sua tag (StoreId) e conecte no App do Parceiro para converter links e buscar produtos.

Ao conectar a Amazon, o App do Parceiro faz duas coisas:

  • Conversor de link — você cola o link de um produto da Amazon e a gente aplica a sua tag de afiliado automaticamente. Aceita amazon.com.br, amazon.com e links curtos amzn.to (seguimos o redirecionamento).
  • Busca de produtos — procurar por palavra-chave ou código ASIN e montar a oferta pronta. Esse recurso usa a Creators API da Amazon e depende da elegibilidade da sua conta (veja abaixo).

💡 A Amazon é uma loja única — não há carteira de lojas nem seleção de anunciante. É só conectar a sua conta e usar.

O que é a Creators API

A Creators API é o conjunto de APIs da Amazon que dá acesso aos dados de produtos para criadores — editores, influenciadores e afiliados — montarem experiências de compra para o seu público. Ela substitui a antiga PA API: hoje o acesso aos dados de produto passa pela Creators API.

Requisitos e elegibilidade

  • Ter uma conta de criador aprovada no Amazon Associados.
  • Estar logado com uma conta com acesso total para criar aplicativos e gerar credenciais.
  • Ter pelo menos 10 vendas qualificadas nos últimos 30 dias para acessar os dados de produto (a busca) pela Creators API.

O conversor de link depende da sua tag; a busca de produtos só fica liberada quando a sua conta atende aos critérios acima.

1. Pegue a sua tag (StoreId)

A sua tag (chamada de StoreId) é o identificador que marca as suas vendas — algo no formato gabiofertas-20. Você a encontra no painel do Amazon Associados.

⚠️ Você pode ter mais de uma tag. Use sempre a mesma tag da conta em que você criou o aplicativo e gerou as credenciais (passo seguinte) — senão a integração não funciona.

2. Crie o aplicativo e gere as credenciais

  1. Acesse o portal do Amazon Associados: 🔗 associados.amazon.com.br/home

  2. Vá em Ferramentas → API para Creators (é a nova API; não é mais a "PA API").

  3. Crie um aplicativo.

  4. Dentro do aplicativo, crie uma credencial e copie os dois valores:

    • ID da credencial — no formato amzn1.application-oa2-client.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
    • Segredo — no formato amzn1.oa2-cs.v1.XXXXXXXXXXXXXXXXXXXX…

    ⚠️ Guarde o Segredo com cuidado — ele aparece na criação e não deve ser compartilhado.

Você pode ter até 2 aplicativos, cada um com 2 conjuntos de credenciais. O segundo conjunto serve para você rodar as chaves (trocar uma pela outra) sem perder o acesso, mas os dois funcionam de forma independente.

3. Conecte no App do Parceiro

Com o ID da credencial, o Segredo e a sua tag (StoreId) em mãos, cadastre a integração no painel web:

  1. Abra Integrações no menu lateral.
  2. Encontre a Amazon na lista e clique para abrir.
  3. Preencha o ID da credencial, o Segredo e a sua tag (StoreId) nos campos indicados e clique em Conectar.

💻 Por enquanto, a Amazon é configurada no painel web.

4. Prazo de liberação

Depois de criar a credencial, pode levar até 48 horas para a Amazon analisar a sua elegibilidade e liberar o acesso. Nesse período, a busca de produtos pode retornar o erro AssociateNotEligible — é esperado. Se o erro persistir por mais de 48 horas, é sinal de que a conta ainda não atende aos critérios (por exemplo, as 10 vendas qualificadas nos últimos 30 dias). Enquanto isso, o conversor de link segue funcionando normalmente.

A Amazon não expõe painel de ganhos pela API — o desempenho das suas ofertas você acompanha direto no painel do Associados.

Perguntas frequentes

Quem está elegível para usar a Creators API? Você precisa de uma conta de criador aprovada e estar logado com uma conta com acesso total para criar aplicativos e gerar credenciais.

Como sei se estou qualificado para acessar os dados de produto (busca)? Além da conta de criador aprovada, você precisa ter pelo menos 10 vendas qualificadas nos últimos 30 dias.

Quanto tempo depois de criar a credencial eu tenho acesso? Pode levar até 48 horas para a análise e liberação. Durante esse tempo, você pode ver o erro AssociateNotEligible. Se ele persistir por mais de 48 horas, a conta não atendeu aos critérios de elegibilidade.

Preciso mexer em SDK ou programar algo? Não. No App do Parceiro basta cadastrar o ID da credencial, o Segredo e a sua tag (passos acima) — o painel cuida da integração.

Posso ter mais de uma credencial? Sim. Você cria até 2 aplicativos, cada um com 2 conjuntos de credenciais (úteis para rodar as chaves). Copie e guarde cada chave num lugar seguro.