Cara Menggunakan API Facebook (Meta) Ad Library untuk Iklan

API Perpustakaan Iklan Facebook/Meta yang kami sebut sebagai API Perpustakaan Iklan Facebook, adalah antarmuka yang tersedia untuk umum yang memberikan akses kepada pengembang ke iklan yang diterbitkan di Facebook, Instagram, dan platform lain milik Meta (misalnya Whatsapp dan Threads). Melalui API ini Anda dapat mencari iklan berdasarkan kata kunci, ID halaman, negara, atau jenis iklan, dan mengambil metadata seperti materi iklan, rentang pengeluaran, tayangan, platform penerbit, dan banyak lagi.

API ini sangat berguna untuk penelitian transparansi, audit pemasaran, analisis kompetitif, analisis materi iklan, atau membangun alat seputar data iklan media sosial. Baik Anda ingin memantau iklan aktif, mempelajari iklan politik atau isu sosial (iklan SIEP), atau menganalisis strategi pemasaran, API Perpustakaan Iklan Facebook menawarkan pintu yang ampuh menuju data iklan.

Mengapa Menggunakan API Perpustakaan Iklan Facebook dan Apa yang Bisa Anda Lakukan Dengannya?

Beberapa kemampuan utama dari API Perpustakaan Iklan Facebook:

1. Cari berdasarkan kata kunci, ID halaman, negara, jenis iklan — Anda dapat mempersempit iklan berdasarkan kontennya, siapa yang menempatkannya, di mana iklan tersebut berjalan, dan jenis kampanye apa yang sedang dilakukan.
2. Filter berdasarkan status: aktif/tidak aktif, rentang pengeluaran, tayangan — berguna ketika Anda hanya ingin iklan yang sedang berjalan atau iklan yang di atas/di bawah ambang pengeluaran tertentu.
3. Ambil metadata iklan — termasuk bidang seperti page_name, ad_snapshot_url, spend, impressions, publisher_platforms (Facebook/Instagram), dan lainnya.
4. Dukungan untuk cakupan data jangka panjang dan luas — misalnya, secara global untuk iklan SIEP, dan untuk banyak wilayah untuk iklan umum (sesuai dengan kebijakan wilayah Meta mulai tahun 2025)
5. Akses gratis ke data publik — tidak ada biaya di muka untuk mengambil data iklan publik, selama Anda memiliki pengaturan akses yang tepat.

Singkatnya — API menyediakan cara yang terstruktur dan dapat diprogram untuk menjelajahi dan mengumpulkan data iklan dalam skala besar.

Panduan Langkah demi Langkah: Cara Memulai dengan API Perpustakaan Iklan Facebook

Langkah 1: Verifikasi Akun & Identitas Facebook/Meta Anda

• Masuk ke/buat akun Facebook Anda (pribadi atau bisnis).
• Pastikan akun Anda terverifikasi (Meta terkadang memerlukan verifikasi identitas untuk akses API). (Verifikasi akun)
• Langkah ini penting terutama jika Anda berencana untuk meminta akses ke data perpustakaan iklan melalui sebuah aplikasi.

Langkah 2: Daftarkan Aplikasi Pengembang Meta

• Kunjungi Meta for Developers → “Mulai” dan masuk ke platform. (Klik di sini)

• Buat Aplikasi baru: pilih “Lainnya” atau jenis umum jika Anda tidak beriklan.

• Pilih bahwa Anda ingin akses ke Marketing API / Ad-Library.

• Awalnya, aplikasi akan dalam mode Pengembangan — ini cukup untuk pengujian dasar dan penggunaan skala kecil.

Langkah 3: Hasilkan Token Akses

• Gunakan Graph API Explorer atau alat Meta untuk menghasilkan token akses pengguna.
• Pastikan token memiliki izin yang diperlukan (misalnya ads_read, mungkin ads_archive atau lainnya tergantung pada persyaratan Meta). (Facebook untuk Pengembang)

Catatan: token akses akan kedaluwarsa; Anda mungkin perlu memperpanjangnya atau menghasilkan token berumur panjang tergantung pada penggunaan Anda.

Langkah 4: Lakukan Panggilan API Pertama Anda

Anda dapat membuat kueri ke endpoint /ads_archive (akar dari API Perpustakaan Iklan). Gunakan versi API terbaru (misalnya v23.0 atau yang lebih baru). (Facebook untuk Pengembang)

Contoh: menggunakan curl

curl -G \
  -d "search_terms=skincare" \
  -d "ad_reached_countries=['US']" \
  -d "ad_active_status=ACTIVE" \
  -d "fields=page_name,ad_snapshot_url,spend,impressions,publisher_platforms" \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  "https://graph.facebook.com/v23.0/ads_archive"

Contoh: menggunakan JavaScript (fetch)

const response = await fetch(
  `https://graph.facebook.com/v23.0/ads_archive?` +
  `search_terms=skincare&ad_reached_countries=['US']&ad_active_status=ACTIVE` +
  `&fields=page_name,spend,impressions,publisher_platforms` +
  `&access_token=YOUR_ACCESS_TOKEN`
);
const data = await response.json();
console.log(data);

Respons JSON akan menyertakan larik objek iklan, masing-masing dengan metadata seperti page_name, ad_snapshot_url, rentang pengeluaran, rentang tayangan, platform penerbit, dan potensi bidang lainnya.

Langkah 5: Menangani Paginasi & Hasil Besar

Karena Perpustakaan Iklan dapat mengembalikan banyak hasil, API menggunakan paginasi. Bersiaplah untuk mengulang halaman-halaman berikutnya — periksa respons untuk token paging atau kursor dan ulangi sesuai dengan itu. Pengembang sering membangun perulangan dalam kode untuk mengumpulkan set hasil yang besar.

Langkah 6: Kasus Penggunaan — Apa yang Dapat Anda Lakukan dengan Data Ini?

Berikut adalah kasus penggunaan umum:

1. Analisis kompetitif — mengambil iklan dari Halaman Facebook pesaing (melalui ID halaman) untuk mempelajari materi iklan mereka, estimasi pengeluaran, atau jangkauan target.
2. Pemantauan & penelitian tren — melacak jenis iklan apa yang aktif berdasarkan kata kunci, wilayah, jenis media, atau jenis iklan (misalnya politik, perumahan, isu sosial).
3. Dasbor intelijen pemasaran — mengumpulkan data (rentang pengeluaran, tayangan, frekuensi iklan) dan memvisualisasikannya dari waktu ke waktu atau di berbagai wilayah.
4. Analisis / inspirasi materi iklan — mengambil dan mengarsipkan materi iklan (URL gambar/video) untuk inspirasi produk atau audit kepatuhan.
5. Penelitian akademik / transparansi — menggunakan data iklan untuk studi tentang periklanan politik, kampanye isu sosial, atau tren pasar.

Kasus penggunaan ini menyoroti nilai memiliki akses terstruktur dan terprogram ke data iklan.

Menguji API Perpustakaan Iklan Facebook dengan Apidog

Gunakan Apidog sebagai tempat pengujian untuk API Perpustakaan Iklan Facebook. Berikut cara memulai pengujian API Anda di Apidog:

1. Di Apidog buat endpoint API baru: atur metode ke GET, URL ke https://graph.facebook.com/v23.0/ads_archive.

2. Di bawah parameter kueri, tambahkan parameter seperti search_terms, ad_reached_countries, fields, dan access_token.

3. Tekan “Kirim” — Apidog akan mengambil data dan menunjukkan respons JSON dalam bentuk terstruktur.

4. Anda dapat bereksperimen dengan berbagai kombinasi parameter, menguji paginasi, dan bahkan menyimpan contoh respons untuk dokumentasi atau analisis.

Pendekatan ini sangat berguna untuk eksplorasi data iklan cepat, pengujian kueri pencarian, dan membangun integrasi tanpa menulis kode lengkap.

Pertanyaan yang Sering Diajukan

Q1. Apakah saya memerlukan Akun Iklan atau akun bisnis khusus untuk menggunakan API Perpustakaan Iklan Facebook?
Tidak — akun Meta yang terverifikasi biasanya sudah cukup. Namun, Anda harus mendaftarkan Aplikasi Pengembang Meta dan mendapatkan token akses dengan izin yang sesuai (misalnya ads_read, ads_archive). Beberapa pengguna perlu menyelesaikan verifikasi identitas untuk akses penuh.

Q2. Bisakah saya mendapatkan data untuk iklan apa pun (bukan hanya iklan politik atau isu sosial)?
Ya — API mendukung iklan umum (tidak hanya SIEP). Anda dapat menggunakan ad_type=all (atau menghilangkan filter) tergantung pada wilayah dan ketersediaan iklan.

Q3. Berapa banyak iklan yang bisa saya ambil dalam satu permintaan?
Secara default, API mengembalikan sejumlah iklan terbatas per permintaan (paginasi). Untuk mengambil lebih banyak, Anda perlu mengulang halaman menggunakan kursor paginasi yang disediakan dalam respons.

Q4. Bisakah saya mengakses materi iklan (gambar, video) melalui API?
Anda mendapatkan ad_snapshot_url atau bidang serupa yang menautkan ke pratinjau materi iklan. Namun, Meta tidak selalu menyediakan file media langsung — mengambil gambar atau video aktual mungkin memerlukan langkah tambahan.

Q5. Adakah cara untuk mengotomatiskan pengambilan data dan menghindari masalah kedaluwarsa token?
Ya — Anda dapat menghasilkan token berumur panjang di alat pengembang Meta atau menyiapkan sistem backend yang secara berkala menyegarkan token. Untuk pengambilan data skala besar, menggabungkan manajemen token dengan perulangan paginasi adalah hal yang umum. Selalu simpan token dengan aman.

Kesimpulan

API Perpustakaan Iklan Facebook (Meta) menyediakan gerbang yang kuat dan terstruktur ke data iklan — memungkinkan pengembang, pemasar, peneliti, dan analis untuk secara terprogram mencari, mengumpulkan, dan menganalisis kampanye iklan di seluruh platform Meta. Menggunakannya, Anda dapat membangun dasbor, melakukan analisis kompetitif, melakukan penelitian transparansi, atau mengumpulkan materi iklan dalam skala besar.

Dengan menyiapkan aplikasi pengembang Meta, mendapatkan token akses yang tepat, dan membuat permintaan ke endpoint /ads_archive — opsional menguji melalui alat seperti Apidog — Anda dapat membuka banyak data perpustakaan iklan. Meskipun ada batasan (izin, batas laju, paginasi, pengambilan media), manfaatnya seringkali lebih besar daripada usahanya.

Bagi siapa pun yang membutuhkan data iklan publik dari Facebook/Meta — API Perpustakaan Iklan adalah pilihan yang berharga, resmi, dan fleksibel.