Salt okunur ölçüm API’si

Yapay zeka görünürlük verinizi kendi panolarınıza, e-tablolarınıza veya ajans raporlarınıza çekin. JSON veya CSV, her entegrasyon için ayrı anahtar, yalnızca çalışma alanınızın verisi.

Kimlik doğrulama

Hesabım, API anahtarları bölümünden anahtar oluşturun (yalnızca çalışma alanı sahipleri). Bearer belirteci olarak gönderin. Anahtarın tamamı bir kez gösterilir; yalnızca özeti saklanır. İptal edilen anahtar bir sonraki istekte çalışmaz.

curl -H "Authorization: Bearer aeo_YOUR_KEY" \
  "https://YOUR-AEODA-DOMAIN/api/v1/brands/BRAND_ID/scores?from=2026-09-01&limit=50"

# CSV
curl -H "Authorization: Bearer aeo_YOUR_KEY" -o scores.csv \
  "https://YOUR-AEODA-DOMAIN/api/v1/brands/BRAND_ID/scores?format=csv&delimiter=semicolon"

Planlar

API, Pro ve Agency planlarına dahildir. CSV dışa aktarma Starter’dan itibaren dahildir. Plan düşerse mevcut anahtarlar, çalışma alanı yeniden yükseltilene kadar 403 döndürür.

Plan düşerse anahtarlar askıya alınır ve 403 döner; çalışma alanı yükselttiği anda yeniden çalışır. Anahtarlar silinmez.

Uçlar

Tüm uçlar GET ve salt okunurdur. Temel adres: aeoda alan adınız.

Uç	Döndürür
GET /api/v1/brands	Markalarınız (kimlik, ad, alan adı, pazar).
GET /api/v1/brands/{brandId}/scores	Skor geçmişi: tarih, motor, skor, güven aralığı, anılma oranı.
GET /api/v1/brands/{brandId}/answers	Cevaplar: prompt, motor, anıldı mı, sıra, duygu, rakipler, cevap metni.
GET /api/v1/brands/{brandId}/sources	Atıf yapılan kaynaklar: alan adı, URL, cevap sayısı, bizim mi rakip mi.
GET /api/v1/brands/{brandId}/competitors	Rakip karşılaştırma: marka, skor, SOV.
GET /api/v1/brands/{brandId}/recommendations	Eylem planı: başlık, öncelik, efor, durum.

Sorgu parametreleri

from ve to: YYYY-MM-DD biçiminde tarihler (varsayılan son 30 gün, planınızın geçmiş penceresiyle sınırlı). limit: 1 ile 1000 arası (varsayılan 100). cursor: önceki sayfanın nextCursor değeri. format: json (varsayılan) veya csv. delimiter: comma veya semicolon (CSV). lang: öneri başlıklarının dili. Bilinmeyen parametreler 400 döndürür.

Örnek

{
  "data": [
    {
      "brand": "Northwind Coffee",
      "date": "2026-10-01T09:00:00.000Z",
      "engine": "all",
      "score": 55,
      "ci_low": 40,
      "ci_high": 70,
      "mention_rate": 25,
      "sov": 31.5,
      "avg_position": 2.4
    }
  ],
  "nextCursor": "eyJ0IjoiMjAyNi0xMC0wMSAwOTowMDowMCswMCIsImlkIjoiLi4uIn0",
  "range": { "from": "2026-09-01", "to": "2026-10-18" }
}

CSV biçimi

CSV, Excel’in aksanları doğru açması için bayt sıra işaretli UTF-8’dir. = + - @ ile başlayan metin hücrelerinin başına formül enjeksiyonunu önlemek için kesme işareti eklenir. CSV yanıtları akış olarak gelir ve 100.000 satırla sınırlıdır: sınıra takılırsanız (413) tarih aralığını daraltın.

Hız sınırı ve sayfalama

Her anahtar dakikada 60 isteğe izin verir. Yanıtlar x-ratelimit-limit ve x-ratelimit-remaining başlıklarını taşır; 429 yanıtında retry-after bulunur. JSON listeleri nextCursor ile sayfalanır (son sayfada null).

format=csv için ayrı, daha düşük bir sınır vardır: anahtar başına saatte 6 indirme; yanıt 50 MB ile sınırlıdır (kesilen dosyanın son satırı "# truncated" olur).

Hatalar

401Anahtar yok, biçimi hatalı veya iptal edilmiş.
403Çalışma alanı planı API içermiyor.
404Marka çalışma alanınızda yok.
413CSV satır sınırı aşıldı: daha kısa tarih aralığı kullanın.
429Hız sınırına ulaşıldı: retry-after saniye bekleyin.