Inizia con l'API

L'API di Gloriads permette ai tuoi strumenti — un foglio di calcolo, uno script, un'automazione — di leggere il tuo account.

È di sola lettura. Una chiave legge il tuo account e non cambia nulla. L'API è inclusa in ogni piano e durante la prova gratuita.

Per interrogare un assistente IA sul tuo account non serve nessuna chiave: vedi Collega un assistente IA.

1. Crea una chiave

Impostazioni → API → Crea una chiave. Dalle il nome dello strumento che la userà, poi copia la chiave. Inizia con key_live_ e viene mostrata una sola volta. Solo il proprietario e gli amministratori dell'account possono creare chiavi.

Quante chiavi puoi avere e come revocarne una: Autenticazione e chiavi API.

2. Fai la tua prima chiamata

Ogni richiesta va a https://gloriads.com/api/v1 e porta la tua chiave nell'intestazione Authorization:

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

/account dimostra che la chiave funziona, descrive l'account a cui appartiene e dice fino a che giorno arrivano i tuoi dati di 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 è error, ricollega Amazon Ads in Impostazioni → Amazon Ads: finché non lo fai, i dati smettono di aggiornarsi.

3. Esplora tutti gli endpoint

Le tue prestazioni confrontate con un periodo precedente, i tuoi prodotti, le tue campagne TV in streaming, le tue campagne con le loro parole chiave e i loro annunci, le tue regole e tutto ciò che Gloriads ha fatto su Amazon: Cosa legge l'API elenca ogni endpoint con un esempio. Il riferimento dell'API mostra ogni parametro e ogni risposta, con un pulsante Try it.

Limiti

60 richieste al minuto e 10.000 al giorno per account. Oltre l'uno o l'altro, l'API risponde 429 con un'intestazione Retry-After: vedi Errori.