Panduan API Taboola: Endpoint Backstage, Autentikasi dan Penggunaan Nyata

API Taboola — secara resmi API Backstage — adalah antarmuka REST Taboola untuk pengiklan. Anda melakukan autentikasi dengan kredensial klien OAuth 2.0, lalu membaca dan menulis semua yang dapat Anda sentuh di Konsol Iklan: kampanye, item kreatif, penargetan, anggaran, dan laporan kinerja, semua di bawah https://backstage.taboola.com/backstage/api/1.0/{account_id}/…. Ini adalah lapisan yang digunakan pembeli media untuk mengotomatisasi perubahan tawaran dan anggaran, mengunggah kreatif secara massal, menyinkronkan pengeluaran ke gudang data, dan membangun mesin aturan yang tidak ditawarkan UI Taboola. Apa yang sengaja tidak diekspos adalah data orang lain — untuk pandangan kompetitif jaringan, Anda memerlukan API yang sama sekali berbeda, yang kami bahas di akhir.

Cakupan API Backstage#

Backstage mencerminkan konsol pengiklan hampir satu-ke-satu. Dalam praktiknya, empat area melakukan sebagian besar pekerjaan:

• Manajemen kampanye. Buat, baca, perbarui, dan jeda kampanye; atur CPC, anggaran harian dan total, penargetan geo/platform, dan pemblokiran situs. Apa pun yang akan Anda ubah secara manual pukul 7 pagi setelah memeriksa angka semalaman dapat menjadi skrip.
• Item (kreatif). Setiap kampanye berisi item — unit gambar-plus-judul yang benar-benar disajikan. API memungkinkan Anda menambahkan item secara massal, memperbarui statusnya, dan membaca status tinjauan per-item, yang merupakan cara akun besar mengirimkan puluhan varian kreatif tanpa menyentuh UI. (Jika Anda masih menyiapkan kampanye pertama Anda secara manual, mulailah dengan panduan penyiapan kampanye Taboola — API mengasumsikan Anda sudah mengetahui konsep konsol.)
• Pelaporan. Endpoint kinerja teragregasi yang diiris berdasarkan dimensi — hari, kampanye, situs, negara, platform, item — bahan baku untuk optimasi otomatis apa pun.
• Kamus. Endpoint pencarian untuk enumerasi yang menjadi dasar segalanya: kode negara, platform, segmen audiens.

Akses datang sebagai ID klien dan rahasia yang diterbitkan untuk akun Anda — secara historis diminta melalui manajer akun Taboola — dan referensi Backstage resmi adalah sumber kebenaran untuk bentuk endpoint dan prosedur akses terkini. Jalur endpoint di bawah ini berlaku hingga tulisan ini; verifikasi terhadap referensi sebelum membangun.

Autentikasi: kredensial klien ke token bearer#

Backstage menggunakan alur kredensial klien OAuth 2.0 standar. Tukarkan ID dan rahasia Anda untuk token:

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

Respons berisi access_token yang Anda kirim sebagai header bearer pada setiap panggilan:

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

Panggilan allowed-accounts itu adalah permintaan pertama yang tepat: mengembalikan nilai account_id (ID numerik dan nama yang dapat dibaca) yang dibutuhkan setiap endpoint lain di jalurnya. Token kedaluwarsa — simpan satu dalam cache dan segarkan pada 401 daripada membuat token baru per permintaan, baik untuk latensi maupun karena permintaan token dibatasi kecepatan lebih agresif daripada permintaan data.

Endpoint yang akan benar-benar Anda gunakan#

Endpoint pelaporan mengambil parameter kueri start_date dan end_date ditambah filter opsional, dan segmen dimension (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) menentukan irisan. site_breakdown adalah yang paling penting untuk optimasi: ini adalah umpan kinerja per-penerbit yang menggerakkan otomatisasi daftar blokir.

Apa yang sebenarnya diotomatisasi pembeli media#

API membayar biaya penyiapannya dalam empat pekerjaan berulang:

1. Mesin aturan. Yang klasik: setiap jam, tarik site_breakdown untuk kampanye aktif; situs mana pun yang telah menghabiskan lebih dari N× target CPA dengan nol konversi dimasukkan ke daftar situs yang diblokir kampanye melalui pembaruan kampanye. Ini adalah putusan potong-yang-kalah yang sama yang dijalankan setiap pengiklan Taboola serius secara manual — terkode, tanpa emosi, dan berjalan pukul 3 pagi.
2. Manajemen tawaran. Menyesuaikan CPC kampanye (dan pengubah tawaran per-situs jika tersedia) naik pada hari dan geo yang melampaui target, turun saat CPA melayang — penyesuaian kecil, sering, membosankan yang terakumulasi.
3. Operasi kreatif massal. Mengunggah 30 varian judul/gambar per kampanye, menjeda semua yang di bawah median CTR mingguan, dan menjaga rotasi kreatif tetap di depan kelelahan tanpa sore hari penuh klik.
4. Pipa pengeluaran. Pekerjaan malam hari menarik campaign-summary per hari ke gudang data, sehingga pengeluaran Taboola mendarat di sebelah pendapatan konversi dan setiap saluran lain dalam satu dasbor.

Rencana integrasi minimal#

Jika Anda mulai dari nol, urutan ini membuat Anda mencapai otomatisasi yang berguna dalam kira-kira satu hari kerja, dengan setiap langkah dapat diverifikasi sebelum yang berikutnya:

1. Putaran token. Tukar kredensial untuk token dan panggil allowed-accounts. Jika ini berhasil, autentikasi dan izin terselesaikan.
2. Pelaporan baca-saja. Tarik campaign-summary per hari untuk minggu terakhir dan rekonsiliasi angka-angka terhadap Konsol Iklan. Jangan tulis apa pun sampai bacaan Anda cocok dengan yang ditunjukkan UI.
3. Satu mutasi aman. Jeda dan batalkan jeda satu kampanye uji via PUT. Konfirmasi perubahan muncul di konsol dan status penyajian mengikuti.
4. Sinkronisasi pengeluaran malam hari. Jadwalkan tarikan pelaporan ke basis data Anda. Ini saja membenarkan integrasi untuk sebagian besar tim.
5. Mesin aturan, dalam mode uji-kering. Hitung keputusan pemblokiran situs dan catat apa yang akan terjadi selama seminggu sebelum membiarkannya menulis. Membandingkan pilihannya dengan yang Anda buat secara manual adalah QA termurah yang pernah Anda jalankan.

Melewatkan langsung ke langkah lima adalah kesalahan standar — bug jalur-tulis terhadap akun iklan aktif adalah pelajaran yang mahal.

Batas kecepatan dan hal-hal praktis yang perlu diperhatikan#

• Hormati batas. Backstage memberlakukan batas kecepatan per-akun; batch bacaan (satu panggilan laporan per kampanye per jam, bukan satu per menit) dan mundur pada 429. Periksa referensi untuk batas terkini daripada berasumsi.
• Pelaporan tertinggal penyajian. Data jam-jam terakhir stabil seiring waktu; bangun aturan berdasarkan data setidaknya beberapa jam lama atau Anda akan menjeda kampanye pada angka yang tidak lengkap.
• Edit tidak instan. Perubahan kampanye menyebar ke penyajian dengan penundaan, dan edit item dapat memicu ulang tinjauan. Otomatisasi harus mentoleransi celah daripada menerbitkan ulang tulisan "gagal".
• Simpan ID, bukan nama. Nama kampanye dan item diedit oleh manusia; ID numerik adalah kunci gabungan yang stabil.
• Lindungi jalur tulis. Mesin aturan dengan bug dapat menjeda seluruh pengeluaran akun atau 10× tawaran. Catat setiap mutasi, tambahkan batasan wajar (jangan pernah mengubah tawaran lebih dari X% per putaran), dan mulai aturan baru apa pun dalam mode uji-kering.

API Taboola lainnya: data kompetitif#

Semua hal di atas melihat tepat satu akun: milik Anda. Backstage tidak akan pernah memberi tahu Anda pengiklan mana yang sedang berkembang dalam vertikal Anda, kreatif apa yang mereka jalankan, atau berapa lama kampanye pesaing bertahan — jaringan tidak menerbitkan pustaka ikalannya sendiri, dan tidak ada endpoint resmi yang mengekspos aktivitas pengiklan lain.

Itulah celah yang dicakup oleh API pengembang OpenAdLibrary. Indeks menyimpan 206.000+ kreatif Taboola aktif (Juli 2026) di dalam korpus 725.000+ iklan native di 49 jaringan, dan data yang sama di balik pustaka iklan Taboola dapat dipertanyakan via REST: cari kreatif berdasarkan pengiklan, vertikal, geo, dan umur panjang; tarik judul dan halaman arahan; lacak kapan pesaing meluncurkan dan menghentikan kampanye. Panduan API data iklan native mendokumentasikan endpoint, dan jika alur kerja Anda berada di agen LLM ada server MCP yang mengekspos korpus yang sama sebagai alat untuk Claude dan ChatGPT. Kunci gratis mencakup penggunaan ringan dan harga tetap datar untuk sisanya; lanskap akses intelijen iklan programatik yang lebih luas disurvei di alat mata-mata iklan dengan API.

Kedua API ini secara alami saling melengkapi: Backstage mengotomatisasi eksekusi di akun Anda, API intelijen mengotomatisasi riset di akun semua orang lain. Pembeli yang mendapatkan hasil maksimal dari otomatisasi menjalankan keduanya — mesin aturan menjaga kampanye mereka sendiri terpangkas, dan umpan kompetitif memberi tanda ketika pengiklan baru mulai berkembang di vertikal mereka sehingga uji coba berikutnya tidak pernah dipilih secara buta. Mulailah dengan alat mata-mata Taboola untuk melihat korpus kompetitif di peramban, lalu ambil kueri yang sama secara programatik ketika alur kerja terbukti.