Primeiros passos com a API

A API do Gloriads permite que as suas próprias ferramentas — uma planilha, um script, uma automação — leiam a sua conta.

Ela é somente leitura. Uma chave lê a sua conta e não altera nada. A API está incluída em todos os planos e durante o teste grátis.

Para fazer perguntas sobre a sua conta a um assistente de IA, você não precisa de chave: veja Conectar um assistente de IA.

1. Criar uma chave

Configurações → API → Criar uma chave. Dê a ela o nome da ferramenta que vai usá-la e copie a chave. Ela começa com key_live_ e é mostrada uma única vez.

Quantas chaves você pode ter e como revogar uma: Autenticação e chaves de API.

2. Fazer a primeira chamada

Toda requisição vai para https://gloriads.com/api/v1 e leva a sua chave no cabeçalho Authorization:

curl https://gloriads.com/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

/account comprova que a chave funciona, descreve a conta à qual ela pertence e diz até que dia vão os seus números do Amazon Ads:

{
  "is_demo": false,
  "subscription": { "status": "active" },
  "api_key": {
    "name": "My script",
    "start": "key_live_ab12",
    "scopes": ["read"],
    "created_at": "2026-09-15T07:55:00.000Z",
    "last_used_at": null
  },
  "connected_app": null,
  "amazon_ads": {
    "connection": "connected",
    "marketplaces": 3,
    "performance_data": {
      "currency": "USD",
      "first_date": "2021-03-01",
      "last_date": "2026-10-09",
      "synced_at": "2026-10-10T06:12:00.000Z",
      "is_syncing": false,
      "history_complete": true
    }
  }
}

Se connection for error, reconecte o Amazon Ads em Configurações → Amazon Ads: os números deixam de ser atualizados até você fazer isso.

3. Explorar todos os endpoints

Seu desempenho comparado com um período anterior, seus produtos, suas campanhas de Streaming TV, suas campanhas com as palavras-chave e os anúncios delas, suas regras e tudo o que o Gloriads fez na Amazon: O que a API lê lista todos os endpoints com um exemplo. A referência da API mostra todos os parâmetros e respostas, com um botão Try it.

Limites

60 requisições por minuto e 10.000 por dia por conta. Acima de qualquer um dos dois, a API responde 429 com um cabeçalho Retry-After: veja Erros.