API-uri pentru biblioteci de anunțuri comparate: Meta vs TikTok vs Google vs OpenAdLibrary

Un API pentru bibliotecă de anunțuri îți oferă acces programatic la un set de date de transparență a anunțurilor — anunțurile în sine plus metadate precum advertiser, datele de difuzare și uneori cheltuieli — astfel încât să poți construi fluxuri de monitorizare, instrumente de cercetare sau agenți AI în loc să dai clic printr-o interfață web. În 2026 contează patru opțiuni: API-ul Meta Ad Library (oficial, condiționat în spatele verificării identității, cel mai profund pentru anunțurile politice și cele servite în UE), API-ul TikTok Commercial Content Library (oficial, cu sfera de aplicare în UE, orientat spre cercetare), setul de date politic al Google (oficial dar îngust — Centrul de Transparență Ads în sine nu are API public) și API-ul OpenAdLibrary (independent, acoperind rețelele native/de web deschis care nu publică deloc nicio bibliotecă oficială). Ele diferă clar în ceea ce privește fricțiunea de acces, acoperirea și câmpurile, așa că alegerea corectă este în mare parte o funcție a canalului pe care trebuie să-l vezi.

Ce contează ca un API pentru bibliotecă de anunțuri — și cine are nevoie de unul#

O bibliotecă de anunțuri este o arhivă căutabilă a anunțurilor pe care o platformă le-a servit; versiunea API este același corpus expus ca date structurate. Consumatori tipici:

• Fluxuri de inteligență competitivă — extrageri nocturne ale unui set de concurenți în propriul depozit de date sau tablou de bord.
• Cercetători și jurnaliști — analiza cheltuielilor electorale, studii de responsabilitate a platformelor, audituri de transparență a anunțurilor.
• Echipe de protecție a mărcii și conformitate — detectarea utilizării abuzive a afiliaților, a aprobărilor false și a funnel-urilor imitatoare la scară.
• Constructorii de produse — oricine livrează o funcționalitate care are nevoie de date live despre anunțuri în spate.
• Agenți AI — LLM-urile care răspund la "ce rulează marca X chiar acum?" au nevoie de un API (sau server MCP) dedesubt.

Un lucru demn de știut înainte de a evalua orice: majoritatea produselor comerciale de spionaj a anunțurilor expun date doar prin interfața lor. Accesul API autentic este suficient de rar încât păstrăm o listă scurtă separată de instrumente de spionaj a anunțurilor cu API.

API-ul Meta Ad Library#

API-ul oficial Meta Ad Library este opțiunea cea mai consolidată și cea mai condiționată. Accesul necesită un cont de dezvoltator Facebook plus un pas de verificare a identității, iar procesul durează timp real — planifică zile, nu minute.

Ce primești odată intrat: căutare după cuvinte cheie și după Pagină în bibliotecă, cu o profunzime a datelor care variază în funcție de categoria anunțului și regiune. Anunțurile despre alegeri, politică și probleme sociale returnează intervale de cheltuieli, intervale de impresii și defalcări demografice. Anunțurile livrate utilizatorilor din UE poartă câmpuri din Legea serviciilor digitale — rezumate de acoperire și segmentare. Anunțurile comerciale obișnuite din afara UE returnează creativitatea, datele și plasamentele, dar nicio cifră legată de performanță și, în general, părăsesc setul de date odată ce devin inactive.

Fricțiunile practice sunt predictibile: obstacole de verificare, limite de rată per token, acoperire comercială slabă în afara UE și nicio dată despre pagina de destinație sau funnel. Este instrumentul potrivit pentru cercetarea anunțurilor politice și analiza cu sfera de aplicare în UE; este un instrument parțial pentru inteligența competitivă. Definițiile câmpurilor și termenii se schimbă — verifică documentația curentă a lui Meta înainte de a proiecta o schemă în jurul ei.

API-ul TikTok Commercial Content Library#

Biblioteca de Conținut Comercial TikTok este o suprafață de transparență din era DSA care acoperă anunțuri și conținut comercial livrat în UE (plus unele piețe adiacente). API-ul din spatele ei este destinat cercetătorilor și necesită o cerere; aprobarea nu este instantanee și nu este universală.

Acoperirea este principala constrângere: dacă întrebarea ta este despre anunțurile TikTok servite în UE, acesta este răspunsul oficial. Dacă întrebarea ta este despre SUA, sau despre performanță, în mare parte nu este — primești identitatea advertiser-ului, datele, intervalele de acoperire și rezumatele de segmentare pentru anunțurile din sfera de aplicare și nimic pentru regiunile din afara sferei de aplicare. Ca și în cazul Meta, tratează documentația curentă TikTok ca sursa de adevăr pentru câmpuri și eligibilitate.

Google: transparență fără API#

Centrul de Transparență Google Ads este o interfață web — nu există un API public general pentru el. Ceea ce există programatic este mai îngust: Google publică un set de date de publicitate politică (cheltuieli, date despre advertiser și segmentare pentru anunțurile electorale în regiunile acoperite) ca set de date public BigQuery, care este excelent pentru scopul său și inutil pentru cercetarea comercială competitivă.

Pentru anunțurile Google obișnuite nu există deloc acces programatic oficial. Scraping-ul Centrului de Transparență încalcă termenii de serviciu și se defectează în mod obișnuit, așa că majoritatea echipelor acceptă pur și simplu decalajul — sau acoperă web-ul deschis din partea de ofertă în schimb.

API-ul OpenAdLibrary: biblioteca de anunțuri a web-ului deschis#

Ecosistemul de publicitate nativă — Taboola, Outbrain, MGID, Revcontent, MediaGo, Microsoft Audience Network — nu publică nicio bibliotecă oficială de anunțuri. OpenAdLibrary umple acel gol în mod independent, prin captarea continuă a plasărilor publice live, rezolvarea advertiser-ului din spatele fiecărui anunț și trasarea clicului până la pagina de destinație.

Corpusul din spatele API-ului, din iulie 2026: peste 725.000 de creativități de anunțuri native live pe 49 de rețele de la peste 29.000 de advertiseri, susținute de peste 6,8 milioane de observații de anunțuri și peste 1,3 milioane de pagini de destinație capturate.

API-ul în sine este o suprafață REST (/api/v1) cu autentificare prin chei auto-servite — fără proces de cerere, fără verificare de identitate. Poți căuta anunțuri după cuvânt cheie, advertiser, rețea, verticală, geo și dispozitiv; câmpurile per creativitate includ imaginea în calitate completă, titlul, rețeaua, datele (văzut prima dată/văzut ultima dată), marca rezolvată și URL-ul paginii de destinație trasat. Cheile gratuite poartă o limită zilnică mică de solicitări pentru evaluare; planul plătit ($29.99/lună) ridică limitele — vezi prețurile pentru cotele curente și prezentarea generală a API-ului de date pentru anunțuri native pentru referința câmp cu câmp.

Două unghiuri specifice OpenAdLibrary demne de notat:

• Longevitatea ca câmp de prim rang. Deoarece captarea este continuă, datele (văzut prima dată/văzut ultima dată) vin cu fiecare creativitate — cel mai apropiat proxy public pentru "acest anunț este profitabil" și ceva pe care niciunul dintre API-urile oficiale nu îl expune pentru anunțurile comerciale.
• Un server MCP pentru agenți. Același corpus este expus ca instrumente la mcp.openadlibrary.com pentru Claude, ChatGPT și alți clienți MCP. Dacă "consumatorul tău de API" este un LLM, calea MCP sări peste infrastructura HTTP în întregime.

Comparație paralelă#

Note practice înainte de a construi#

Câteva lucruri care îi lovesc pe dezvoltatori la prima lor integrare cu o bibliotecă de anunțuri, indiferent de furnizor:

• Compară, nu arunca. Semnalul util este schimbarea — creativități noi, creativități oprite, advertiseri noi într-o verticală. Extrage un set fix pe un program și compară-l cu ultima ta captură instantanee în loc să reingerezi întreaga lume.
• Arhivează creativitățile care te interesează. URL-urile imaginilor din orice set de date de anunțuri se pot deteriora pe măsură ce CDN-urile expiră activele. Dacă o creativitate contează pentru analiza ta, stochează propria copie la momentul extragerii.
• Respectă cotele. Fiecare opțiune de aici limitează rata. Proiectează pentru backoff din prima zi și grupează interogările după advertiser în loc să emiți un apel per creativitate.
• Citește termenii. API-urile de reglementare, în special, restricționează redistribuirea și reutilizarea comercială a datelor lor — ceea ce poți stoca, afișa și revinde diferă în funcție de sursă.

Alegerea după cazul de utilizare#

• Cercetare politică sau electorală → API-ul Meta Ad Library plus setul de date politic al Google. Pentru asta au fost construite, iar datele despre cheltuieli sunt reale.
• Cercetare de conformitate a platformelor în UE → TikTok CCL plus câmpurile DSA ale lui Meta.
• Monitorizare competitivă socială → API-ul lui Meta, acceptând obstacolul de verificare și datele comerciale slabe din afara UE.
• Inteligență competitivă nativă și pe web deschis — cercetare afiliați, analiză funnel, protecție mărci — → OpenAdLibrary, pentru că nicio sursă oficială nu acoperă aceste rețele deloc.
• Fluxuri de lucru cu agenți și LLM → MCP mai întâi, REST ca rezervă.

Rezumatul sincer: API-urile oficiale pentru biblioteci de anunțuri sunt artefacte de reglementare — profunde exact acolo unde reglementarea a forțat profunzimea (anunțuri politice, livrare în UE) și superficiale peste tot în rest. Dacă anunțurile de care îți pasă rulează pe web-ul deschis, ruta independentă nu este opțiunea de compromis; este singura opțiune.