Facebook Reklam Kütüphanesi API'si: Nasıl Kullanılır, Neler Gösterir ve Gerçek Sınırları Nelerdir?
Bu blog yazısı, Facebook Reklam Kütüphanesi API'sinin nasıl çalıştığını, hangi verileri sunduğunu ve rakip reklamlarını araştırırken birçok pazarlamacının neden bu API'nin sınırlarını aştığını açıklıyor.

Yazan:
Kinnari Ashar
Okuma süresi: 20 dk.

Facebook Reklam Kütüphanesi API'si, Meta'nın tıklamalar yerine kod kullanarak Facebook ve Instagram'daki herkese açık reklamları keşfetmenizi sağlayan resmi aracıdır. Reklamları daha önce manuel olarak araştırmayı denediyseniz, bunun ne kadar hızlı bir şekilde sinir bozucu hale geldiğini zaten biliyorsunuzdur. Sayfaları teker teker aramak, bölgeleri değiştirmek ve aktif kampanyaları takip etmek ölçeklendirmeye pek uygun değildir.
İnsanların API'ye yönelmeye başlamasının nedeni de budur; çünkü Reklam Kütüphanesi arayüzünde saatler harcamadan hız, düzen ve rakipleri, ürünleri veya pazarları incelemenin bir yolunu isterler.
Araştırma seçeneklerini değerlendiren bir pazarlamacı, manuel kontroller ile araçlar arasında karar vermeye çalışan bir stoksuz satış (dropshipping) uzmanı veya reklam istihbaratı için otomasyonu keşfeden bir ajanssanız, bu rehber tam size göredir. Yalnızca API'nin ne olduğunu öğrenmekle kalmayacaksınız. Gerçek araştırma senaryolarında nasıl çalıştığını ve nerede yetersiz kaldığını da göreceksiniz.
Önemli Noktalar
Facebook Reklam Kütüphanesi API'si, herkese açık Facebook ve Instagram reklamlarına otomatik erişim sağlar.
Kullanımı; geliştirici kurulumu, izin onayları ve düzenli erişim belirteci (access token) yönetimi gerektirir.
API içgörüler değil, ham reklam kayıtları döndürür; bu da kreatiflerin manuel olarak incelenmesi gerektiği anlamına gelir.
Satışlar, kâr ve net harcama gibi performans verileri mevcut değildir.
Çoğu e-ticaret kullanıcısı için API, öğrenme ve gözlem açısından faydalıdır ancak uzun vadede hızlı kararlar almak için güvenilmesi zordur.
Facebook (Meta) Reklam Kütüphanesi API'si Nedir?
Meta, herkesin Facebook ve Instagram'da yayınlanan reklamları aramasına olanak tanıyan herkese açık bir Reklam Kütüphanesi sunar. Şu anda aktif olan veya geçmişte gösterilen reklamları listeler ve manuel kullanım için tasarlanmış bir web arayüzü üzerinden erişilir.
Facebook Meta Reklam Kütüphanesi API'si, bu kütüphanenin otomatikleştirilmiş karşılığı olarak hizmet verir. Artık reklamları sayfa sayfa gezmek zorunda kalmazsınız; çünkü herkese açık reklam verilerinin yapılandırılmış bir formatta alınmasını sağlayarak tekrarlayan manuel aramalar olmadan büyük ölçekli analizleri mümkün kılar.
Buna erişim aynı zamanda Meta Platforms'un Graph API'si üzerinden yönetilir, bu nedenle Reklam Kütüphanesi API'si basit bir oturum açma akışı yerine geliştirici izinlerine ihtiyaç duyar.

Facebook Reklam Kütüphanesi API'si Hangi Verileri Sağlar?
Facebook Reklam Kütüphanesi API'si, Meta'nın şeffaflık adına sunduğu herkese açık reklam bilgilerinin aynısını içerir. Reklamların neye benzediğini, arkasında kimin olduğunu ve nerede yayınlandıklarını göstermeye odaklanır.
Reklam kreatifleri söz konusu olduğunda API, kampanyalarda kullanılan net mesajları ve görselleri incelemenize olanak tanır. Çoğu kişinin bunu kreatif araştırması için kullanmasının nedeni de budur.
Şunları içerir:
Reklamda kullanılan görseller ve videolar
Ana reklam metni, başlıklar ve açıklamalar
Kullanıcılara gösterilen harekete geçirici mesaj (CTA) butonları
Reklamı orijinal formatında açan anlık görüntü (snapshot) bağlantıları
Kreatiflerin yanı sıra API, reklamı kimin yayınladığını ve nasıl yayınlandığını da gösterir. Bu, her reklamı bir bağlama oturtmaya yardımcı olur. Şunları gösterir:
Reklamı yayınlayan Facebook Sayfası
Reklamın göründüğü ülkeler
Yayın durdurulduysa başlangıç tarihi ve bitiş tarihi
Reklamın şu anda aktif mi yoksa pasif mi olduğu
Bütçe ve erişim verileri de dahil edilir ancak yalnızca genel düzeyde sunulur.
Tahmini aralıklar olarak gösterilen harcama
Yaklaşık erişimi gösteren gösterim aralıkları
Meta Platforms, tam bütçeleri ifşa etmekten veya kampanya performansının tersine mühendislikle kolayca çözülmesini önlemek için bu bilgileri aralıklar halinde sunar.
Facebook Reklam Kütüphanesi API'si Neleri GÖSTERMEZ?
Kullanıcının bir reklama tıklamasından sonra gerçekleşen hiçbir şey dahil edilmez ve performans metrikleri reklamverene özel kalır.
Özellikle, Facebook Reklam Kütüphanesi API'si şunları sağlamaz:
Dönüşüm verileri
Satış veya gelir rakamları
ROAS veya CPA metrikleri
Hedef kitle hedefleme detayları
Bir reklamın karlı olup olmadığını doğrulayan herhangi bir sinyal
Bu kısıtlamalar kasıtlı olarak yapılmaktadır. Meta Platforms, reklamverenlerin stratejilerinin veya sonuçlarının açığa çıkmasını önlemek amacıyla performans ve hedefleme verilerine erişimi sınırlandırır.
Facebook Reklam Kütüphanesi API'si Gerçekte Kimler İçin Uygundur?
Reklam Kütüphanesi API'si, reklam kayıtlarını toplu olarak çekmek için tasarlanmıştır. Bundan fazlası değildir.
Bu nedenle, halihazırda büyük ölçekte çalışan ekipler için uygundur. Büyük markalar ve ajanslar, pazarlar, kategoriler veya rakipler genelindeki reklam faaliyetlerini izlemek için bunu kullanır. API, trendlerin, hacim değişikliklerinin veya kreatif faaliyetlerin reklam bazında tek tek değerlendirilmek yerine zaman içinde izlendiği dahili panoları besler.
Ayrıca birden fazla mağaza, pazar veya ürün grubu yöneten ve ham verileri işleyecek teknik altyapıya sahip büyük ölçekli dropshipping satıcıları için de kullanışlıdır. Bu gibi durumlarda API, hızlı doğrulamayı değil, pazar takibini ve kreatif analizini destekler.
Ancak çoğu danışman veya reklamcı için pek kullanışlı değildir. Örneğin, küçük bir mağaza işletiyorsanız, ürünleri test ediyorsanız veya bir reklamın kopyalanmaya değer olup olmadığına karar vermeye çalışıyorsanız API pek yardımcı olmaz. Hedeflemeyi göstermez. Dönüşümleri göstermez. Bir reklamın para kazandırıp kazandırmadığını size söylemez.
Facebook Reklam Kütüphanesi API'sine Nasıl Erişim Sağlanır?
Adım 1: Meta Geliştirici Hesabı Oluşturun
Gerçek bir kişisel profil kullanarak Facebook'a giriş yaparak başlayın. Temel testler için bile olsa, anonim veya paylaşılan hesaplar geliştirici erişimi için kullanılamaz.
Giriş yaptıktan sonra Meta'nın geliştirici portalı üzerinden geliştirici olarak kaydolun. Bu, kişisel Facebook hesabınızı geliştirici ayrıcalıklarına bağlar ve daha sonra API erişimi talep etmenize olanak tanır.
Sosyal konular, seçimler veya siyasetle ilgili reklamlar için ek doğrulama gereklidir. Meta, kimliğinizi Facebook.com/ID üzerinden doğrulamanızı ister. Bu süreç kişisel bilgilerin gönderilmesini içerir ve onayın tamamlanması birkaç gün sürebilir.
Bu gereklilik kasıtlıdır. Meta Platforms, şeffaflık ve kötüye kullanımın önlenmesi için kimlik doğrulamasını temel bir adım olarak görür.
Adım 2: Bir Geliştirici Uygulaması Oluşturun
Meta geliştiricisi olarak kaydolduktan sonra geliştirici kontrol paneline gidin ve yeni bir uygulama oluşturma seçeneğini belirleyin.
İstendiğinde, Pazarlama veya işle ilgili erişimi destekleyen bir uygulama türü seçin. Uygulamayı adlandırıp geliştirici hesabınıza atayarak temel kurulumu tamamlayın.
Uygulama oluşturulduktan sonra, tüm Reklam Kütüphanesi API isteklerinin yapıldığı kaynak haline gelir. Her izin talebi, erişim belirteci ve kullanım limiti bu uygulamaya bağlıdır.
Tüm Reklam Kütüphanesi API istekleri bu uygulama üzerinden yapılır. Bu adım isteğe bağlı değildir; çünkü zaten geliştirici erişiminiz olsa bile uygulama olmadan reklam verisi talep etmenin hiçbir yolu yoktur.
Adım 3: Reklamları Okuma İzni Talep Edin
Uygulama hazır olduğunda, Reklam Kütüphanesi verilerine erişime izin veren yetkiyi talep edersiniz. Bu izin, uygulamanızın reklamları okuyup okuyamayacağını kontrol eder.
Meta isteğinizi inceleyebilir veya doğrulama talep edebilir.
Adım 4: Erişim Belirteci (Access Token) Oluşturun
Reklam Kütüphanesi API'sine herhangi bir istek göndermeden önce bir erişim belirteci gereklidir; çünkü Meta, isteği kimin gönderdiğini ve bu isteğe izin verilip verilmediğini doğrulamak için bunu kullanır.
Belirteci, geliştirici uygulamanızı seçerek Graph API Explorer üzerinden oluşturursunuz. Bağlı Facebook hesabı Reklam Kütüphanesi erişimi için kimlik doğrulamasını tamamladığı sürece temel bir kullanıcı erişim belirteci yeterlidir.
Her API isteği bu belirtece bağlıdır. Belirtecin süresi dolduğunda, yenisini oluşturana kadar istekler başarısız olur. Bu noktada, ilk kez kullanan birçok kişi belirtecin süresinin dolup dolmadığını bilmediği için takılıp kalır.
Geçerli bir belirteç ile, verilerin döndürüldüğünü onaylamak için Graph API Explorer'da basit bir Reklam Kütüphanesi sorgusu çalıştırarak erişimi test edebilirsiniz.
Facebook Reklam Kütüphanesi API'si Nasıl Kullanılır?
Adım 1: Araştırma Hedefinizi Belirleyin
Herhangi bir API isteğinde bulunmadan önce, verilerin yanıtlamasını istediğiniz net bir soru yazın. API yalnızca açıkça talep ettiğiniz verileri döndürür.
Tek bir odak noktası seçerek başlayın:
araştırmak istediğiniz bir ürün anahtar kelimesi
belirli bir reklamveren veya Facebook Sayfası
tek bir ülkede gösterilen reklamlar
aktif reklamlar veya yayını durdurulmuş reklamlar
Bu aşamada birden fazla hedefi birleştirmeyin.
Bir ürünü araştırıyorsanız reklam metninde geçen anahtar kelimeleri girin. Bir rakibi analiz ediyorsanız sonuçları o reklamverenin sayfasıyla sınırlandırın. Coğrafi konum önemliyse sonuçları tek bir ülkeyle sınırlayın. Aktif reklamları mı, geçmiş reklamları mı yoksa her ikisini birden mi istediğinize önceden karar verin.
Bunu atlamayın; çünkü bu adımı atlamak, API'nin alakasız geniş reklam kümeleri döndürmesine neden olur. Veriler doğru olabilir ancak sizin için faydalı olmayacaktır.
Adım 2: Reklam Verilerini Talep Edin
Neyi aramak istediğinize karar verdikten sonra, Facebook'a reklamları isteyen bir talep gönderirsiniz.
Bu işlem Facebook Graph API üzerinden yapılır. Erişim belirtecinizi ve anahtar kelimeler, ülkeler, reklam durumu veya belirli bir reklamveren gibi daha önce seçtiğiniz filtreleri dahil edersiniz. Test için birçok kişi Graph API Explorer'ı kullanır. Düzenli kullanım için bu genellikle kod aracılığıyla gerçekleşir.
Facebook isteği işler ve erişim belirtecinizin ile izinlerinizin geçerli olup olmadığını kontrol eder. Geçerliyse sonuçları geri gönderir.
Elde ettiğiniz şey göz atabileceğiniz bir sayfa değildir. Yanıt ham veridir. Reklamları ve ilgili ayrıntıları listeler ancak hiçbir görsel, özet veya sıralama bulunmaz. Sıralamak, karşılaştırmak veya incelemek istediğiniz her şey bu adımdan sonra yapılmalıdır.
Adım 3: Dönen Verileri İnceleyin
Her reklam kaydı, referans alabileceğiniz küçük bir alan kümesi içerir. Bunlar genellikle bir kreatif önizleme bağlantısını, reklamı yayınlayan Facebook Sayfasını ve harcama ile gösterim aralıklarını içerir. Bu bilgiler hangi reklamların dikkate değer olduğunu daraltmanıza yardımcı olur ancak kreatifin kendisini göstermez.
Gerçek reklamı görüntülemek için önizleme bağlantısını manuel olarak açmanız gerekir. Görselleri, videoları ve mesajları orijinal formatlarında görmenin tek yolu budur.
Buradaki iş basittir. Dönen reklamlara bakın, araştırma hedefinize uyanları seçin ve yalnızca önemli olan kreatifleri açın. Meta Platforms verileri sağlar ancak reklamları incelemek ve yorumlamak yine de manuel değerlendirme gerektirir.
Adım 4: Tüm Sonuçları Toplayın (Sayfalandırma / Pagination)
Bir arama sonucunun hacmi yüksek olduğunda, API sonucu birden fazla parçaya böler. Buna sayfalandırma (pagination) denir ve yükü yönetmek için yapılır.
İlk yanıtı aldıktan sonra daha fazla sonucun bulunup bulunmadığını kontrol edin; varsa bir sonraki reklam kümesini almak için tekrar istek göndermeniz gerekir. Bu işlemin geriye sonuç kalmayana kadar yapılması gerekir.
Bu, sık yapılan bir hatadır. API ek partiler döndürmeyi bırakana kadar istek göndermeye devam ettiğinizden emin olun. Tüm sonuçları almazsanız, özellikle hacim yüksek olduğunda çıkarımlarınız hatalı olabilir.
Adım 5: Reklamları Manuel Olarak Analiz Edin
Tüm reklamları topladıktan sonra, bunları üzerinde çalışabileceğiniz bir e-tablo veya tablo gibi bir biçimde dışa aktarın ya da listeleyin. Bu, karşılaştırma yapmayı mümkün kılar.
İlk olarak, reklamları reklamverene veya ürüne göre gruplandırın. Aynı Facebook Sayfasından gelen reklamları bir araya getirin veya aynı tür ürünü tanıtan reklamları kümeleyin. Bu, dağınıklığı azaltır ve kalıpların daha hızlı ortaya çıkmasına yardımcı olur.
Ardından, her reklamın önizleme bağlantısını açın ve kreatifleri tek tek inceleyin. Bunu yaparken üç şeye dikkat edin:
küçük değişikliklerle tekrarlanan kreatifler
daha uzun süredir yayında olan reklamlar
birden fazla reklamda görünen mesajlar veya açılar
Şimdi, aynı gruptaki reklamları karşılaştırın. Mesajların nasıl evrildiğine, hangi formatların yeniden kullanıldığına ve belirli fikirlerin sürekli görünüp görünmediğine bakın. Bu tekrarlar, tek bir reklamdan çok daha önemlidir.
Bu adım en çok zaman alan adımdır çünkü hiçbir şey otomatik değildir. Her kalıbın reklamlar manuel olarak incelenerek tespit edilmesi gerekir.
Pazarlamacılar İçin Facebook Reklam Kütüphanesi API Kullanım Senaryoları
Rakip Reklam Araştırması
Facebook Reklam Kütüphanesi API'si, manuel aramalara bağımlı kalmadan rakiplerin ne tür reklamlar verdiğini takip etmek için sıklıkla kullanılır. Belirli bir Facebook Sayfasına bağlı reklamları çekerek, tüm aktif ve geçmiş kampanyaları tek bir yerde inceleyebilirsiniz.
Bu, markaların teklifleri nasıl sunduğunu, ne tür kreatifler kullandıklarını veya hangi mesaj açılarının tekrar tekrar ortaya çıktığını anlamada faydalıdır. Reklamları yan yana görebildiğiniz ve değişiklikleri fark edip kreatiflerin ne sıklıkla değiştiğini görebildiğiniz için bu şekilde çalışmak daha kolaydır.
Bu verilerin göstermediği şey ise performanstır. API; dönüşümleri, geliri veya karlılığı ortaya koymaz. Bunun için manuel çalışmayı kendiniz yapmalısınız.
Pazar ve Niş Araştırması
Pazar düzeyinde araştırma için pazarlamacılar, reklam faaliyetinin nerede olduğunu ve ne kadar yoğun olduğunu anlamak amacıyla Facebook Reklam Kütüphanesi API'sini kullanır. Amaç kazanan ürünleri bulmak değil, bir alanın ne kadar kalabalık veya aktif göründüğünü tespit etmektir.
API'nin bu amaçla yaygın olarak kullanıldığı durumlar şunlardır:
Hangi sektörlerde yüksek sayıda aktif reklam olduğunu kontrol etmek
Birden fazla reklamverenin ne zaman benzer ürünleri tanıtmaya başladığını görmek
Bir ülkedeki reklam faaliyeti miktarını diğeriyle karşılaştırmak
Siyasi ve Şeffaflık Araştırmaları
E-ticaret ve ürün araştırmalarının dışında, Facebook Reklam Kütüphanesi API'si siyasi ve mesele bazlı reklamları izlemek için de yaygın olarak kullanılır. Burada amaç optimizasyon değil, kayıt tutma ve karşılaştırmadır.
Siyasi kampanyaları takip etmek ve belirli partiler veya kuruluşlar tarafından hangi reklamların yayınlandığını görmek
Seçimler veya önemli olaylar sırasında mesajların zaman içinde nasıl değiştiğini incelemek
Sosyal veya siyasi meselelerin farklı ülkelerde nasıl reklamlaştırıldığını karşılaştırmak
API neyin ve nerede iletildiğini incelemeyi mümkün kılar, ancak erişim etkinliği veya kamuoyu tepkisi hakkında içgörü sağlamaz.
Facebook Reklam Kütüphanesi API'sinin Sınırları
Herkese açık reklam verilerine erişim sağlar ancak hız, ölçek veya sürekli izleme için tasarlanmamış olması gibi kendi sınırlamaları vardır. Bu sınırlar, düzenli veya büyük sorgular çalıştırmaya başladığınızda netleşir.
İstek sınırları (Rate limits) - İstekler sınırlandırılmıştır. Çok sık sorgu yaptığınızda veya büyük veri kümeleri çektiğinizde yanıtlar yavaşlar veya başarısız olur.
Performans yükü - Her istek kimlik doğrulamasından ve işlemeden geçer. Sorguları tekrarlamak belirgin gecikmelere yol açar.
Verimsiz veri alma - Bazı istekler gerekenden daha fazla veri döndürürken, diğerleri tek bir görünümü tamamlamak için birden fazla çağrı gerektirir.
Gerçek zamanlı güncellemelerin olmaması - Reklamlar anında görünmez. Güncellemeleri otomatik olarak almak yerine yeni verileri sürekli manuel kontrol etmeniz gerekir, bu da oldukça zaman alıcı bir iştir.
Sürekli bakım gereksinimi - Belirteçlerin süresi dolar, izinler değişir ve iş akışları uyarı yapılmaksızın bozulabilir.
WinningHunter: Facebook Reklam Kütüphanesi API'si İçin En İyi Alternatif
Birçok pazarlamacı için Facebook Reklam Kütüphanesi API'si erişim sorununu çözer ancak farklı türde bir sürtünme yaratır. Kurulum zaman alır, izinlerin bakımının yapılması gerekir ve çıktı, hala yorumlanması gereken ham verilerden ibarettir. Teknik iş akışlarına sahip olmayan ekipler için bu durum yardımcı olmak yerine işleri sıklıkla yavaşlatır.
Birçok pazarlamacının doğrudan API kullanımı yerine araçları tercih etmesinin nedeni budur. Araçlar kurulum zahmetini ortadan kaldırır ve belirteçler, istekler veya sayfalandırma ile uğraşmadan verileri hemen incelenebilecek bir biçimde sunar.
WinningHunter, amaç veri toplamaktan ziyade karar vermek olduğunda bu iş akışına mükemmel uyum sağlar. API erişimi gerektirmeden herkese açık reklam verilerini kullanır ve bunu kullanıma hazır filtreler ile panolar aracılığıyla sunar. Reklam kayıtlarını tek tek incelemek yerine, gerçekten önemli olanları hızla daraltabilirsiniz.
Ayrıca Reklam Kütüphanesi API'sinde eksik olan reklam puanlaması, harcama sinyalleri ve mağaza veya ürün etkinliği etrafındaki tahminler gibi bağlamları da ekler. Bu, test sürecinin yerini tamamen almaz ancak alakalı olma olasılığı düşük reklamları manuel olarak incelemek için harcanan zamanı azaltmaya yardımcı olur.
Sıkça Sorulan Sorular
Facebook Reklam Kütüphanesi API'sini kullanmak ücretsiz mi?
Evet, Meta Facebook Reklam Kütüphanesi API'sini kullanmak için ücret talep etmez. Herkese açık reklam verilerine herhangi bir ücret ödemeden erişebilirsiniz. Bunun yerine harcadığınız şey zamandır. Bir geliştirici hesabına, onaylara ve sürekli erişim belirteci yönetimine ihtiyacınız vardır. Belirteçlerin süresi dolduğunda veya izinler geçersiz olduğunda bunu kendiniz düzeltmek zorundasınız. Çoğu kullanıcı için bu devam eden iş yükü, asıl maliyet haline gelir.
Yeni başlayanlar için kullanımı ne kadar zor?
Yeni başlayanların çoğu için hızlıca öğrenmesi zor gelir. API sizi yönlendirmez veya sonuçları açıklamaz. Ham yanıtlar ve hata mesajlarıyla çalışırsınız. İnsanlar izinler, eksik sonuçlar veya belirteç sorunları konusunda nedenini anlamadan kafa karışıklığı yaşayabilir. API'lere veya yapılandırılmış verilerle çalışmaya alışkın değilseniz, süreç öğretici olmaktan çok yavaş ve sinir bozucu olma eğilimindedir.
Facebook Reklam Kütüphanesi API'si kazanan (başarılı) reklamları gösterebilir mi?
Hayır. Sonuçları göstermez. Satışları, dönüşümleri, kârı veya reklam harcamasının getirisini (ROAS) göremezsiniz. Bir reklamın uzun süre görünür olması, işe yaradığı anlamına gelmez. Sadece yayınlandığı anlamına gelir. API performansla değil, şeffaflıkla ilgilidir ve hangi reklamların gerçekte başarılı olduğuna karar vermenize yardımcı olmaz.
API kullanmayı ne zaman bırakıp bir araca geçmeliyim?
API kullanımı kararlarınızı geciktirmeye başladığında geçiş yapmalısınız. Zamanınızın büyük kısmı veri çekmeye, verileri temizlemeye ve reklamları tek tek incelemeye gidiyorsa API artık yardımcı olmuyor demektir. Bu genellikle kayıtlara ham erişim sağlamak yerine hıza, önceliklendirmeye veya doğrulamaya ihtiyaç duyduğunuzda gerçekleşir.











