taskType ADS and a platform, and the response lists the ads with the same core fields: libraryId, the advertiser (pageName on Meta, advertiserName elsewhere), format, startDate, endDate, activeDays, landingDomain, nextCursor and a summary of the ads returned. A field a library does not publish is null. Every platform costs the same: 0.5 credits for every 30 ads a search returns, and 0.5 credits for advertisers, ad and advertiser.
Which library to use
- A competitor’s Google Search, YouTube and Display ads:
google_ads_transparency. Search by the competitor’sadvertiserId, or by its website withdomainto include every regional entity that advertises it. - A B2B competitor that advertises on LinkedIn:
linkedin_ad_library. Search byadvertiserNameor by the agency inpayer, and open an ad for who paid. - A competitor’s Facebook and Instagram ads, how long each ran, its variants and, in the EU, its reach by country, age and gender:
meta_ad_library. - A competitor’s TikTok ads in Europe, the UK or Brazil with impressions and targeting:
tiktok_ad_library. - The creatives that work on TikTok in the US, Korea, Japan or another of its 28 countries:
tiktok_creative_center. It is a ranked sample, not an advertiser’s full set.
Find a competitor and compare several
- Meta:
advertisersreturns thepageId, andpageIdscompares up to 10 advertisers on one keyword. - Google:
advertisersreturns theadvertiserId, andadvertiserIdscompares up to 10 advertisers. - LinkedIn: no advertiser lookup.
advertiserNamematches part of a name, and one search covers one name. - TikTok Ad Library:
advertisersreturns the exact name, andadvertiserNamecovers one advertiser per search. - TikTok Creative Center: no advertiser lookup, because the ads are a sample by country, industry and objective.