Ad Library API:t vertailussa: Meta vs TikTok vs Google vs OpenAdLibrary

Mainoskirjasto-API tarjoaa ohjelmallisen pääsyn mainosten läpinäkyvyysaineistoon — itse mainoksiin sekä metatietoihin kuten mainostaja, näyttöajankohdat ja joskus kulutus — jotta voit rakentaa seurantaputkia, tutkimustyökaluja tai tekoälyagenteja klikkaamatta verkkokäyttöliittymän läpi. Vuonna 2026 neljä vaihtoehtoa merkitsee: Meta Ad Library API (virallinen, henkilöllisyyden vahvistuksen takana, syvin poliittisille ja EU-alueella näytetyille mainoksille), TikTokin Commercial Content Library API (virallinen, EU-alueella, tutkimusorientoitunut), Googlen poliittisten mainosten tietoaineisto (virallinen mutta kapea — Ads Transparency Centerillä itsellään ei ole julkista API:a) ja OpenAdLibraryn API (riippumaton, kattaa natiivi-/avoimen verkon verkostot, jotka eivät julkaise lainkaan virallista kirjastoa). Ne eroavat jyrkästi pääsyn esteissä, kattavuudessa ja kentissä, joten oikea valinta riippuu pääasiassa siitä, mitä kanavaa sinun täytyy nähdä.

Mikä lasketaan mainoskirjasto-rajapinnaksi — ja kuka sitä tarvitsee#

Mainoskirjasto on hakukelpoinen arkisto alustan näyttämistä mainoksista; API-versio on sama aineisto tarjottuna rakennettuna datana. Tyypilliset käyttäjät:

• Kilpailutiedon keruuputket — kiinteän kilpailijajoukon yönnäytöt omaan varastoon tai kojetauluun.
• Tutkijat ja toimittajat — vaalimainonnan kulutusanalyysit, alustan vastuullisuustutkimukset, mainosten läpinäkyvyys -tarkastukset.
• Brändinsuojaus- ja vaatimustenmukaisuusryhmät — kumppanien väärinkäytösten, väärien suosituksien ja kopiofunneleiden havaitseminen mittakaavassa.
• Tuotteenrakentajat — kuka tahansa, joka julkaisee ominaisuuden, joka tarvitsee live-mainontadataa taustalleen.
• Tekoälyagentit — LLM:t, jotka vastaavat kysymykseen "mitä brändi X näyttää juuri nyt?", tarvitsevat API:n (tai MCP-palvelimen) alla.

Yksi asia, joka kannattaa tietää ennen kuin arvioit mitään: useimmat kaupalliset mainostiedustelutuotteet tarjoavat dataa vain käyttöliittymänsä kautta. Aito API-pääsy on niin harvinaista, että pidämme erillisen lyhyen listan mainostiedustelutyökaluista, joilla on API.

Meta Ad Library API#

Virallinen Meta Ad Library API on vakiintunein vaihtoehto ja eniten portillinen. Pääsy vaatii Facebook-kehittäjätilin sekä henkilöllisyyden vahvistusvaiheen, ja prosessi vie aikaa — suunnittele päiviä, ei minuutteja.

Mitä saat sisäänpääsyn jälkeen: avainsana- ja Sivu-haku kirjaston läpi, ja tietojen syvyys vaihtelee mainoskategorian ja alueen mukaan. Vaaleista, politiikasta ja yhteiskunnallisista aiheista kertovat mainokset palauttavat kulutuskaistoja, näyttömäärävälejä ja demografisia jakautumia. EU-käyttäjille toimitettujen mainosten Digital Services Act -kentät — kattavuus ja kohdentamisyhteenvedot. Tavalliset kaupalliset mainokset EU:n ulkopuolella palauttavat luovan elementin, päivämäärät ja sijoitukset, mutta ei suorituskykyyn liittyviä numeroita, ja ne yleensä poistuvat aineistosta, kun ne eivät ole aktiivisia.

Käytännön esteet ovat ennustettavia: vahvistushypyt, rajalliset kyselymäärät avainta kohti, ohut kaupallinen kattavuus EU:n ulkopuolella, eikä kohdesivun tai funneltietoja. Se on oikea työkalu poliittisten mainosten tutkimukseen ja EU-alueella tapahtuvaan analyysiin; se on osittainen työkalu kilpailutiedon keruuseen. Kenttämääritelmät ja ehdot muuttuvat — tarkista Metan nykyinen dokumentaatio ennen kuin suunnittelet skeeman sen ympärille.

TikTok Commercial Content Library API#

TikTokin Commercial Content Library on DSA-aikakauden läpinäkyvyyspinta, joka kattaa EU:lle (ja joillekin viereisille markkinoille) toimitettuja mainoksia ja kaupallista sisältöä. Sen takana oleva API on suunnattu tutkijoille ja vaatii hakemuksen; hyväksyntä ei ole välitön eikä universaali.

Kattavuus on päärajoitus: jos kysymyksesi koskee EU-alueella näytettyjä TikTok-mainoksia, tämä on virallinen vastaus. Jos kysymyksesi koskee Yhdysvaltoja tai suorituskykyä, se pääasiassa ei ole — saat mainostajan identiteetin, päivämäärät, kattavuusväliä ja kohdentamisyhteenvetoja soveltuville mainoksille, etkä mitään soveltumattomille alueille. Kuten Metan kanssa, käsittele nykyistä TikTok-dokumentaatiota totuuden lähteenä kenttien ja kelpoisuuden suhteen.

Google: läpinäkyvyys ilman API:a#

Googlen Ads Transparency Center on verkkokäyttöliittymä — sille ei ole yleistä julkista API:a. Ohjelmallisesti olemassa oleva on kapeampi: Google julkaisee poliittisen mainonnan tietoaineiston (kulutus, mainostaja ja kohdentamistiedot vaalimainonnasta katetuilla alueilla) julkisena BigQuery-tietoaineistona, mikä on erinomainen tarkoitukseensa ja hyödytön kaupalliseen kilpailutiedon tutkimukseen.

Tavallisille Google-mainoksille ei ole lainkaan virallista ohjelmallista pääsyä. Transparency Centerin kaapiminen rikkoo käyttöehtoja ja menee rikki säännöllisesti, joten useimmat tiimit yksinkertaisesti hyväksyvät aukon — tai kattavat avoimen verkon tarjontapuolelta.

OpenAdLibrary API: avoimen verkon mainoskirjasto#

Natiivimainonnan ekosysteemi — Taboola, Outbrain, MGID, Revcontent, MediaGo, Microsoft Audience Network — ei julkaise lainkaan virallista mainoskirjastoa. OpenAdLibrary täyttää tuon aukon itsenäisesti jatkuvasti kaappaamalla live-julkisia sijoituksia, selvittämällä jokaisen mainoksen takana olevan mainostajan ja jäljittämällä klikkauksen kohdesivulle.

API:n takana oleva aineisto heinäkuussa 2026: 725 000+ live-natiivimainosluovaa elementtiä yli 49 verkostossa yli 29 000 mainostajalta, tuettuna yli 6,8 miljoonalla mainoshavainnolla ja yli 1,3 miljoonalla kaapatulla kohdesivulla.

API itse on REST-pinta (/api/v1) itsepalveluavaimen todennuksella — ei hakemusprosessia, ei henkilöllisyyden vahvistusta. Voit hakea mainoksia avainsanalla, mainostajalla, verkostolla, vertikaalilla, maantieteellä ja laitteella; per-luova elementti -kenttiin kuuluvat täyslaatuinen kuva, otsikko, verkosto, ensimmäinen nähty/viimeksi nähty päivämäärät, selvitetty brändi ja jäljitetty kohdesivun URL. Ilmaiset avaimet sisältävät pienen päivittäisen kyselyrajan arviointiin; maksettu suunnitelma ($29.99/kk) nostaa rajoja — katso hinnoittelu nykyisille kiintiöille ja natiivimainontatieto-API:n yleiskatsaus kenttäkohtaiselle viitteelle.

Kaksi OpenAdLibrary-spesifiä näkökulmaa, jotka kannattaa huomioida:

• Kesto ensiluokkaisena kenttänä. Koska kaappaus on jatkuvaa, ensimmäinen nähty/viimeksi nähty päivämäärät tulevat jokaisen luovan elementin mukana — lähin julkinen proxy sille, että "tämä mainos on kannattava", ja jotain, mitä mikään virallisista API:ista ei paljasta kaupallisille mainoksille.
• MCP-palvelin agenteille. Sama aineisto on saatavilla työkaluina osoitteessa mcp.openadlibrary.com Claudelle, ChatGPT:lle ja muille MCP-asiakkaille. Jos "API-kuluttajasi" on LLM, MCP-reitti ohittaa HTTP-putkistot kokonaan.

Rinnakkainen vertailu#

Käytännön huomioita ennen rakentamista#

Muutamia asioita, jotka purevat kehittäjiä heidän ensimmäisessä mainoskirjasto-integraatiossaan, riippumatta toimittajasta:

• Vertaa, älä tyhjennä. Hyödyllinen signaali on muutos — uudet luovat elementit, lopetetut luovat elementit, uudet mainostajat vertikaalissa. Nouda kiinteä joukko aikataulun mukaan ja vertaa edelliseen tilannekuvaasi sen sijaan, että imisit maailmaa uudelleen.
• Arkistoi luovat elementit, joista välität. Kuvien URL-osoitteet missä tahansa mainosaineistossa voivat vanhentua, kun CDN:t vanhentavat resurssit. Jos luova elementti on tärkeä analyysillesi, tallenna oma kopiosi noutohetkellä.
• Kunnioita kiintiöitä. Jokainen vaihtoehto tässä rajoittaa kyselymääriä. Suunnittele peruutuksiin ensimmäisenä päivänä ja eräile kyselyt mainostajan mukaan sen sijaan, että tekisit yhden kutsun per luova elementti.
• Lue ehdot. Erityisesti sääntelyrajapinnat rajoittavat datan uudelleenjakelua ja kaupallista uudelleenkäyttöä — mitä saat tallentaa, näyttää ja myydä uudelleen, vaihtelee lähteen mukaan.

Valinta käyttötapauksen mukaan#

• Poliittinen tai vaalitutkimus → Meta Ad Library API plus Googlen poliittinen tietoaineisto. Niitä varten ne on rakennettu, ja kulutustiedot ovat todellisia.
• EU-alustan vaatimustenmukaisuustutkimus → TikTok CCL plus Metan DSA-kentät.
• Sosiaalisen median kilpailun seuranta → Metan API, hyväksyen vahvistushypyn ja ohut ei-EU-kaupallisen datan.
• Natiivi- ja avoimen verkon kilpailutiedon keruu — kumppanitutkimus, funnel-analyysi, brändinsuojaus — → OpenAdLibrary, koska mikään virallinen lähde ei kata näitä verkostoja lainkaan.
• Agentti- ja LLM-työnkulut → MCP ensin, REST varana.

Rehellinen yhteenveto: viralliset mainoskirjasto-rajapinnat ovat sääntelyartefakteja — syviä juuri siellä, missä sääntely pakotti syvyyden (poliittiset mainokset, EU-toimitus) ja matalia kaikkialla muualla. Jos mainokset, joista välität, näkyvät avoimella verkolla, riippumaton reitti ei ole kompromissivaihtoehto; se on ainoa vaihtoehto.