Ad Library API-k összehasonlítása: Meta vs TikTok vs Google vs OpenAdLibrary

Egy ad library API programozott hozzáférést biztosít egy hirdetés-átláthatósági adatkészlethez – magukhoz a hirdetésekhez és metaadatokhoz, mint a hirdető, a futási dátumok és néha a költés –, így felügyeleti pipeline-okat, kutatási eszközöket vagy AI-ügynököket építhetsz ahelyett, hogy egy webes felületen kattintgatnál. 2026-ban négy lehetőség számít: a Meta Ad Library API (hivatalos, személyazonosság-ellenőrzés mögé zárt, legmélyebb a politikai és EU-ban kiszolgált hirdetésekhez), a TikTok Commercial Content Library API (hivatalos, EU-körű, kutatás-orientált), a Google politikai hirdetések adatkészlete (hivatalos, de szűk – az Ads Transparency Centernek nincs nyilvános API-ja), és az OpenAdLibrary API (független, lefedi a natív/nyílt webes hálózatokat, amelyek egyáltalán nem tesznek közzé hivatalos könyvtárat). Élesen különböznek a hozzáférési nehézségekben, lefedettségben és mezőkben, így a helyes választás nagyrészt attól függ, melyik csatornát kell látnod.

Mi számít ad library API-nak – és kinek van rá szüksége#

Egy ad library a platform által kiszolgált hirdetések kereshető archívuma; az API verzió ugyanaz a korpusz, strukturált adatként elérhető. Tipikus felhasználók:

• Versenyintelligencia pipeline-ok – éjszakai lekérések egy versenytárs-készletről a saját raktáradba vagy irányítópultodba.
• Kutatók és újságírók – választási költés elemzés, platform-elszámoltathatósági tanulmányok, ad transparency auditok.
• Márkavédelmi és megfelelőségi csapatok – affiliate visszaélések, hamis ajánlások és másoló tölcsérek nagy léptékű észlelése.
• Terméképítők – bárki, aki olyan funkciót szállít, amely mögött élő hirdetési adatokra van szükség.
• AI-ügynökök – LLM-ek, amelyek megválaszolják „mit fut éppen az X márka?” – ehhez API (vagy MCP szerver) kell alatta.

Egy dolgot érdemes tudni, mielőtt bármit értékelsz: a legtöbb kereskedelmi ad-spy termék csak a felületén keresztül teszi elérhetővé az adatokat. A valódi API hozzáférés elég ritka, hogy külön listát vezessünk az API-val rendelkező ad spy eszközökről.

Meta Ad Library API#

A hivatalos Meta Ad Library API a leginkább bevezetett lehetőség, és a leginkább korlátozott. A hozzáféréshez Facebook fejlesztői fiók és egy személyazonosság-ellenőrzési lépés szükséges, és a folyamat valós időt vesz igénybe – számolj napokkal, nem percekkel.

Mit kapsz, ha bejutottál: kulcsszó és Page keresés a könyvtárban, az adatok mélysége a hirdetési kategória és régió szerint változik. A választásokkal, politikával és társadalmi kérdésekkel kapcsolatos hirdetések költési sávokat, impresszió-tartományokat és demográfiai bontásokat adnak vissza. Az EU-felhasználóknak kiszolgált hirdetések Digital Services Act mezőket hordoznak – elérési és célzási összefoglalókat. Az EU-n kívüli hétköznapi kereskedelmi hirdetések a kreatívot, dátumokat és elhelyezéseket adják, de teljesítményhez közeli számokat nem, és általában eltűnnek az adatkészletből, ha inaktívvá válnak.

A gyakorlati nehézségek kiszámíthatók: ellenőrzési akadályok, tokenenkénti sebességkorlátozások, vékony kereskedelmi lefedettség az EU-n kívül, és nincs landoló oldal vagy tölcsér adat. Ez a megfelelő eszköz politikai hirdetések kutatásához és EU-körű elemzéshez; részleges eszköz a versenyintelligenciához. A meződefiníciók és kifejezések változnak – ellenőrizd a Meta aktuális dokumentációját, mielőtt sémát terveznél köré.

TikTok Commercial Content Library API#

TikTok Commercial Content Library egy DSA-korszakbeli átláthatósági felület, amely az EU-ban (és néhány szomszédos piacon) kiszolgált hirdetéseket és kereskedelmi tartalmakat fedi le. A mögötte lévő API kutatóknak szól, és jelentkezést igényel; a jóváhagyás nem azonnali és nem univerzális.

A lefedettség a fő korlát: ha a kérdésed az EU-ban kiszolgált TikTok hirdetésekre vonatkozik, ez a hivatalos válasz. Ha a kérdésed az USA-ról vagy a teljesítményről szól, akkor többnyire nem – a hatókörön belüli hirdetésekhez megkapod a hirdető azonosítóját, dátumokat, elérési tartományokat és célzási összefoglalókat, a hatókörön kívüli régiókhoz semmit. A Meta-hoz hasonlóan a jelenlegi TikTok dokumentációt tekintsd a mezők és jogosultságok forrásának.

Google: transparency without an API#

A Google Ads Transparency Center egy webes felület – nincs hozzá általános nyilvános API. Ami programozottan létezik, az szűkebb: a Google közzétesz egy politikai hirdetési adatkészletet (költés, hirdető és célzási adatok a választási hirdetésekhez a lefedett régiókban) nyilvános BigQuery adatkészletként, ami kiváló a céljára, de használhatatlan a kereskedelmi versenykutatáshoz.

A hétköznapi Google hirdetésekhez egyáltalán nincs hivatalos programozott hozzáférés. A Transparency Center kaparása megsérti a szolgáltatási feltételeket és rendszeresen elromlik, így a legtöbb csapat egyszerűen elfogadja a hiányt – vagy a nyílt webet a kínálati oldalról fedi le helyette.

OpenAdLibrary API: the open web's ad library#

A natív hirdetési ökoszisztéma – Taboola, Outbrain, MGID, Revcontent, MediaGo, a Microsoft Audience Network – nem tesz közzé semmilyen hivatalos ad library-t. Az OpenAdLibrary függetlenül tölti be ezt a hiányt azáltal, hogy folyamatosan rögzíti az élő nyilvános elhelyezéseket, feloldja a hirdetőt minden hirdetés mögött, és nyomon követi a kattintást a landoló oldalig.

Az API mögötti korpusz 2026 júliusában: 725 000+ élő natív hirdetési kreatív 49 hálózaton keresztül 29 000+ hirdetőtől, 6,8 millió+ hirdetési megfigyeléssel és 1,3 millió+ rögzített landoló oldallal alátámasztva.

Maga az API egy REST felület (/api/v1) önkiszolgáló kulcsos hitelesítéssel – nincs jelentkezési folyamat, nincs személyazonosság-ellenőrzés. Kereshetsz hirdetéseket kulcsszó, hirdető, hálózat, vertikum, földrajzi hely és eszköz szerint; a kreatívonkénti mezők tartalmazzák a teljes minőségű képet, címsort, hálózatot, első/megjelenés utolsó észlelése dátumokat, feloldott márkát és a nyomon követett landoló URL-t. Az ingyenes kulcsok egy kis napi lekérési korlátot tartalmaznak a kiértékeléshez; a fizetős csomag (29,99 USD/hó) megemeli a korlátokat – lásd a pricing oldalt az aktuális kvótákért, és a native ad data API overview oldalt a mezőnkénti referenciáért.

Két OpenAdLibrary-specifikus szempont, amit érdemes megjegyezni:

• Élettartam mint első osztályú mező. Mivel a rögzítés folyamatos, az első/megjelenés utolsó észlelése dátumok minden kreatívhoz tartoznak – a legközelebbi nyilvános proxy arra, hogy „ez a hirdetés nyereséges”, és amit a hivatalos API-k egyike sem tesz elérhetővé a kereskedelmi hirdetésekhez.
• Egy MCP szerver az ügynökök számára. Ugyanez a korpusz eszközökként elérhető a mcp.openadlibrary.com címen Claude, ChatGPT és más MCP kliensek számára. Ha az „API-fogyasztód” egy LLM, akkor az MCP útvonal teljesen kihagyja a HTTP csővezetéket.

Side-by-side comparison#

Practical notes before you build#

Néhány dolog, ami a fejlesztőket meglepi az első ad-library integráció során, függetlenül a szállítótól:

• Diffelj, ne dumpolj. A hasznos jel a változás – új kreatívok, leállított kreatívok, új hirdetők egy vertikumban. Húzz le egy rögzített halmazt ütemezetten, és diffeld a legutóbbi pillanatképeddel, ahelyett hogy újra betöltenéd a világot.
• Archiváld a kreatívokat, amelyek fontosak. A kép URL-ek bármely hirdetési adatkészletben elromolhatnak, ahogy a CDN-ek lejáratják az eszközöket. Ha egy kreatív számít az elemzésedben, tárold el a saját másolatodat a lekéréskor.
• Tiszteld a kvótákat. Minden lehetőség itt sebességkorlátozott. Tervezz backoff-ra az első naptól, és kötegeld a lekérdezéseket hirdetőnként, ahelyett hogy kreatívonként egy hívást indítanál.
• Olvasd el a feltételeket. A szabályozási API-k különösen korlátozzák az adataik újraelosztását és kereskedelmi újrafelhasználását – hogy mit tárolhatsz, jeleníthetsz meg és adhatsz el, az forrásonként eltérő.

Choosing by use case#

• Politikai vagy választási kutatás → Meta Ad Library API plusz Google politikai adatkészlete. Erre épültek, és a költési adatok valósak.
• EU platform-megfelelőségi kutatás → TikTok CCL plusz Meta DSA mezői.
• Közösségi média versenyfigyelés → Meta API-ja, elfogadva az ellenőrzési akadályt és a vékony nem EU-s kereskedelmi adatokat.
• Natív és nyílt webes versenyintelligencia – affiliate kutatás, tölcsér elemzés, márkavédelem – → OpenAdLibrary, mert egyetlen hivatalos forrás sem fedi le ezeket a hálózatokat.
• Ügynök és LLM munkafolyamatok → MCP elsőként, REST tartalékként.

Az őszinte összefoglaló: a hivatalos ad library API-k szabályozási műtermékek – pontosan ott mélyek, ahol a szabályozás kikényszerítette a mélységet (politikai hirdetések, EU kiszolgálás), és sekélyek mindenhol máshol. Ha a hirdetések, amelyek érdekelnek, a nyílt weben futnak, akkor a független út nem a kompromisszumos lehetőség; ez az egyetlen lehetőség.