O que cada API cobre

A SP-API cobre a operação de venda como um todo: pedidos, remessas, pagamentos, estoque, preços, listings e relatórios financeiros. A Amazon Ads API cobre exclusivamente a gestão de campanhas publicitárias — Sponsored Products, Sponsored Brands, Sponsored Display — e os relatórios de desempenho dessas campanhas. Não há sobreposição de dados: uma não substitui nem complementa a outra diretamente, são sistemas paralelos.

Caminhos de registro diferentes

Para usar a SP-API, o registro do aplicativo está ligado a uma conta de Seller ou Vendor Central. Para usar a Ads API, o acesso é concedido pela própria Amazon Advertising, e não exige necessariamente uma conta profissional de vendedor como pré-requisito — é possível obter acesso com um login Amazon comum, desde que autorizado a usar a API de anúncios.

Autenticação: parecida, mas não igual

As duas usam OAuth via Login with Amazon (LWA) como base, mas com histórico e exigências diferentes. Até 2 de outubro de 2023, a SP-API também exigia que as requisições fossem assinadas com AWS Signature Version 4, usando credenciais IAM da AWS — a Amazon removeu essa exigência nessa data, e hoje basta incluir o token de acesso LWA no cabeçalho de autorização (Authorization: Bearer <token>), sem assinatura AWS. A Ads API nunca exigiu assinatura AWS: sempre dependeu só do fluxo OAuth 2.0 da LWA, que gera cinco credenciais — Client ID, Client Secret, Access Token, Refresh Token e Profile ID.

O Profile ID da Ads API

Um detalhe que não tem equivalente direto na SP-API: toda chamada específica de conta na Ads API precisa do cabeçalho Amazon-Advertising-API-Scope, contendo o Profile ID — um identificador que representa a conta do anunciante num marketplace específico. Esse Profile ID é obtido chamando o endpoint /v2/profiles. Na prática, uma conta com operação em múltiplos marketplaces (Brasil, EUA, etc.) tem um Profile ID diferente por marketplace, e cada chamada de campanha precisa declarar para qual perfil ela se aplica.

O que isso significa na prática

Uma ferramenta que gerencia tanto estoque/listings quanto campanhas de Ads — como a maioria das plataformas de gestão Amazon — precisa integrar as duas APIs separadamente, com fluxos de autorização distintos e sem reaproveitar token entre elas. Isso também significa que uma falha de autenticação na Ads API não afeta a sincronização de pedidos via SP-API, e vice-versa — são pontos de falha isolados.

Como a EcomVision ajuda

O EcomVision integra a SP-API e a Amazon Ads API separadamente, cada uma com seu próprio fluxo de autorização e renovação de token, para que o módulo de Amazon Ads & Campanhas e os módulos de operação (estoque, financeiro, listings) continuem funcionando de forma independente mesmo que uma das duas precise de reautorização.

Aviso de atualização: requisitos de autenticação, escopos e endpoints de ambas as APIs mudam com o tempo. Consulte sempre a documentação oficial de cada uma para o comportamento vigente.

Fontes