Skip to main content
ADS reads five public ad libraries through one task API. Send 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’s advertiserId, or by its website with domain to include every regional entity that advertises it.
  • A B2B competitor that advertises on LinkedIn: linkedin_ad_library. Search by advertiserName or by the agency in payer, 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: advertisers returns the pageId, and pageIds compares up to 10 advertisers on one keyword.
  • Google: advertisers returns the advertiserId, and advertiserIds compares up to 10 advertisers.
  • LinkedIn: no advertiser lookup. advertiserName matches part of a name, and one search covers one name.
  • TikTok Ad Library: advertisers returns the exact name, and advertiserName covers one advertiser per search.
  • TikTok Creative Center: no advertiser lookup, because the ads are a sample by country, industry and objective.

Keep the history

Libraries drop old ads, and the ads that stopped running are not kept in every country. To keep a competitor’s ad history, search its ads on a schedule, for example every day, and store them. Media URLs expire after a few days on Meta and a few hours on TikTok, and some Google preview links and LinkedIn media expire too.