Reklam Kütüphanesi API'leri Karşılaştırıldı: Meta vs TikTok vs Google vs OpenAdLibrary

Bir reklam kütüphanesi API'si, reklam‑şeffaflığı veri setine programatik erişim sağlar — reklamların kendisi ve reklamveren, yayın tarihleri ve bazen harcama gibi meta veriler — böylece bir web UI üzerinden tıklama yapmadan izleme boru hatları, araştırma araçları veya AI ajanları oluşturabilirsiniz. 2026'da dört seçenek önem taşıyor: Meta Reklam Kütüphanesi API'si (resmi, kimlik doğrulama gerektiren, politik ve AB‑sunulan reklamlar için en derin), TikTok'un Commercial Content Library API'si (resmi, AB‑odaklı, araştırma‑yönelimli), Google'ın politik‑reklam veri seti (resmi ancak dar — Ads Transparency Center'ın kendisi kamuya açık bir API sunmaz) ve OpenAdLibrary API'si (bağımsız, resmi bir kütüphane yayınlamayan yerel/açık‑web ağlarını kapsar). Erişim zorluğu, kapsama ve alanlar açısından keskin farklılıklar gösterirler, bu yüzden doğru seçim büyük ölçüde görmek istediğiniz kanala bağlıdır.

Reklam kütüphanesi API'si ne sayılır — ve kim birine ihtiyaç duyar#

Bir reklam kütüphanesi bir platformun yayınladığı reklamların aranabilir arşividir; API versiyonu aynı veri kümesinin yapılandırılmış veri olarak sunulmasıdır. Tipik tüketiciler:

• Rekabet‑istihbarat boru hatları — rakip setinin gece çekimleri kendi veri ambarınıza veya gösterge panelinize.
• Araştırmacılar ve gazeteciler — seçim‑harcama analizleri, platform‑sorumluluk çalışmaları, reklam şeffaflığı denetimleri.
• Marka koruma ve uyum ekipleri — bağlı kuruluş kötüye kullanımını, sahte onayları ve kopya hunileri ölçekli olarak tespit etme.
• Ürün geliştiricileri — canlı reklam verisine ihtiyaç duyan bir özellik sunan herkes.
• AI ajanları — "Marka X şu anda ne yayınlıyor?" sorusuna cevap veren LLM'ler bir API'ye (veya MCP sunucusuna) ihtiyaç duyar.

Değerlendirmeye başlamadan önce bilmeniz gereken bir nokta: çoğu ticari reklam‑casus ürün veriyi yalnızca UI üzerinden sunar. Gerçek API erişimi o kadar nadirdir ki, ayrı bir API'li reklam casus araçları listesi tutuyoruz.

Meta Reklam Kütüphanesi API#

Resmi Meta Reklam Kütüphanesi API'si en köklü seçenek ve en çok kısıtlananıdır. Erişim bir Facebook geliştirici hesabı ve kimlik doğrulama adımı gerektirir; süreç gerçek zaman alır — planlama günleri, dakikalar değil.

İçeri girince elde ettiğiniz: kütüphane içinde anahtar kelime ve Sayfa araması, veri derinliği reklam kategorisi ve bölgeye göre değişir. Seçim, politika ve sosyal konularla ilgili reklamlar harcama bantları, gösterim aralıkları ve demografik dağılımlar döndürür. AB kullanıcılarına sunulan reklamlar Digital Services Act alanları — erişim ve hedefleme özetleri — içerir. AB dışındaki sıradan ticari reklamlar yaratıcı, tarih ve yerleşimleri döndürür, performans‑ile ilgili sayılar sunmaz ve genellikle veri kümesi pasif hale geldiğinde çıkar.

Uygulayıcı sürtünmeleri öngörülebilir: doğrulama engelleri, token başına oran sınırlamaları, AB dışı ticari kapsama dar olması ve açılış‑sayfası ya da hunı verisi olmaması. Politik‑reklam araştırması ve AB‑odaklı analizler için doğru araçtır; rekabet‑istihbaratı için kısmi bir araçtır. Alan tanımları ve terimler değişir — şema tasarlamadan önce Meta'nın güncel belgelerini kontrol edin.

TikTok Commercial Content Library API#

TikTok'un Commercial Content Library DSA‑dönemi şeffaflık yüzeyi, AB'ye (ve bazı yakın pazarlara) sunulan reklam ve ticari içeriği kapsar. Arkasındaki API araştırmacılara yöneliktir ve bir başvuru gerektirir; onay anında ve evrensel değildir.

Kapsama en büyük sınırlamadır: sorunuz AB‑sunulan TikTok reklamlarıyla ilgiliyse bu resmi cevaptır. ABD veya performansla ilgili sorular çoğunlukla yanıtlanmaz — kapsam dahilindeki reklamlar için reklamveren kimliği, tarih, erişim aralıkları ve hedefleme özetleri sağlanır, kapsam dışı bölgeler için hiçbir şey sunulmaz. Meta gibi, mevcut TikTok belgelerini alanlar ve uygunluk konusunda tek gerçek kaynağı olarak kabul edin.

Google: API olmadan şeffaflık#

Google'ın Ads Transparency Center bir web UI'dir — genel bir kamu API'si yoktur. Programatik olarak mevcut olan daha dar bir şey vardır: Google, kapsanan bölgelerdeki seçim reklamları için harcama, reklamveren ve hedefleme verilerini içeren bir kamuya açık BigQuery veri seti yayınlar; bu amacına çok uygundur ancak ticari rekabet araştırması için kullanılamaz.

Sıradan Google reklamları için resmi bir programatik erişim yoktur. Transparency Center üzerinden scraping hizmet şartlarını ihlal eder ve rutin olarak kırılır; bu yüzden çoğu ekip boşluğu kabul eder — ya da tedarik tarafından açık webı kapsar.

OpenAdLibrary API: açık webün reklam kütüphanesi#

Yerel reklam ekosistemi — Taboola, Outbrain, MGID, Revcontent, MediaGo, Microsoft Audience Network — resmi bir reklam kütüphanesi yayınlamaz. OpenAdLibrary bu boşluğu bağımsız olarak doldurur, canlı kamu yerleşimlerini sürekli yakalar, her reklamın arkasındaki reklamvereni çözer ve tıklamayı açılış sayfasına izler.

API'nin arkasındaki veri kümesi, Temmuz 2026 itibarıyla: 49 ağda 29.000+ reklamverenden 725.000+ canlı yerel reklam yaratıcı, 6.8 milyon+ reklam gözlemi ve 1.3 milyon+ yakalanmış açılış sayfası.

API kendisi bir REST yüzeyidir (/api/v1) ve kendi kendine hizmet veren anahtar kimlik doğrulaması sunar — başvuru süreci, kimlik doğrulama yok. Reklamları anahtar kelime, reklamveren, ağ, sektör, coğrafya ve cihazla arayabilirsiniz; yaratıcı başına alanlar tam‑kalite görsel, başlık, ağ, ilk‑görülme/son‑görülme tarihleri, çözümlenmiş marka ve izlenen açılış URL'si içerir. Ücretsiz anahtarlar değerlendirme için küçük bir günlük istek limiti taşır; ücretli plan ($29.99/mo) limitleri artırır — mevcut kotalar için fiyatlandırma sayfasına bakın ve alan‑alan referans için yerel reklam veri API'si genel bakışı inceleyin.

İki OpenAdLibrary‑özel açıdan değinmeye değer:

• Uzunluk birincil alan olarak. Yakalama sürekli olduğundan, ilk‑görülme/son‑görülme tarihleri her yaratıcıda bulunur — "bu reklam kârlı" diye en yakın kamu göstergesi ve resmi API'lerin ticari reklamlar için sunmadığı bir şey.
• Ajanlar için bir MCP sunucusu. Aynı veri kümesi mcp.openadlibrary.com adresinde Claude, ChatGPT ve diğer MCP istemcileri için araç olarak sunulur. "API tüketiciniz" bir LLM ise, MCP yolu HTTP altyapısını tamamen atlar.

Yan yana karşılaştırma#

Oluşturmadan önce pratik notlar#

Geliştiricileri ilk reklam‑kütüphanesi entegrasyonunda ısıran birkaç nokta:

• Farkı al, tüm veriyi almaz. Kullanışlı sinyal değişimdir — yeni yaratıcılar, durdurulan yaratıcılar, bir sektördeki yeni reklamverenler. Sabit bir seti zamanlayarak çekin ve son anlık görüntünüzle farklayın, tüm dünyayı yeniden içe aktarmayın.
• İlgili yaratıcıları arşivleyin. Her reklam veri setindeki görsel URL'leri CDN'ler süresi dolduğunda kırılabilir. Bir yaratıcı analiziniz için önemliyse, çekim anında kendi kopyanızı saklayın.
• Kotalara saygı gösterin. Buradaki her seçenek oran sınırlamaları uygular. İlk günden geri çekilme (backoff) tasarlayın ve yaratıcı başına bir çağrı yerine reklamveren bazlı toplu sorgular yapın.
• Şartları okuyun. Özellikle düzenleyici API'ler verinin yeniden dağıtımını ve ticari yeniden kullanımını kısıtlar — neyi saklayabileceğiniz, gösterebileceğiniz ve yeniden satabileceğiniz kaynak bazında değişir.

Kullanım durumuna göre seçim#

• Politik veya seçim araştırması → Meta Reklam Kütüphanesi API'si + Google'ın politik veri seti. Bunlar bu amaçla oluşturulmuştur ve harcama verisi gerçektir.
• AB platform‑uyumluluk araştırması → TikTok CCL + Meta'nın DSA alanları.
• Sosyal rekabet izleme → Meta API'si, doğrulama engelini ve AB dışı ticari verinin dar olmasını kabul ederek.
• Yerel ve açık‑web rekabet istihbaratı — bağlı kuruluş araştırması, hunı analizi, marka koruma — → OpenAdLibrary, çünkü bu ağları kapsayan resmi bir kaynak yoktur.
• Ajan ve LLM iş akışları → Öncelikle MCP, geri dönüş olarak REST.

Dürüst özet: resmi reklam kütüphanesi API'leri düzenleyici artefaktlardır — derinlik sadece düzenleme zorunlu kıldığı yerlerde (politik reklamlar, AB teslimi) ve diğer her yerde sığdırılmıştır. Reklamlarınız açık web üzerinde yayınlanıyorsa, bağımsız yol bir tavsiye değil, tek seçenektir.