API'ye başlarken

Gloriads API'si, kendi araçlarınızın (bir elektronik tablo, bir betik, bir otomasyon) hesabınızı okumasını sağlar.

API salt okunurdur. Bir anahtar hesabınızı okur ve hiçbir şeyi değiştirmez. API her plana ve ücretsiz deneme süresine dahildir.

Bir yapay zeka asistanına hesabınızla ilgili soru sormak için anahtara ihtiyacınız yoktur: bkz. Yapay zeka asistanı bağlama.

1. Anahtar oluşturun

Ayarlar → API → Anahtar oluştur. Anahtara, onu kullanacak aracın adını verin, ardından anahtarı kopyalayın. Anahtar key_live_ ile başlar ve yalnızca bir kez gösterilir.

Kaç anahtara sahip olabileceğiniz ve bir anahtarı nasıl iptal edeceğiniz: Kimlik doğrulama ve API anahtarları.

2. İlk çağrınızı yapın

Her istek https://gloriads.com/api/v1 adresine gider ve anahtarınızı Authorization başlığında taşır:

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

/account, anahtarın çalıştığını kanıtlar, ait olduğu hesabı tanımlar ve Amazon Ads rakamlarınızın hangi güne kadar geldiğini söyler:

{
  "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
    }
  }
}

connection değeri error ise Ayarlar → Amazon Ads sayfasından Amazon Ads'i yeniden bağlayın: siz bağlayana kadar rakamlar güncellenmez.

3. Tüm uç noktaları keşfedin

Daha önceki bir dönemle karşılaştırmalı performansınız, ürünleriniz, Streaming TV kampanyalarınız, anahtar kelimeleri ve reklamlarıyla kampanyalarınız, kurallarınız ve Gloriads'in Amazon'da yaptığı her şey: API'nin okuduğu veriler sayfası her uç noktayı bir örnekle listeler. API referansı her parametreyi ve yanıtı bir Try it düğmesiyle gösterir.

Sınırlar

Hesap başına dakikada 60 ve günde 10.000 istek. Bunlardan biri aşıldığında API, Retry-After başlığıyla 429 yanıtı verir: bkz. Hatalar.