> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ad libraries compared

> Pick the ad library for a competitor analysis: the countries, retention and EU-only fields of the Meta, Google, LinkedIn and TikTok ad libraries that the ADS taskType reads.

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`.

| `platform` | Ads shown on | Countries | What the library keeps | Only for ads shown in the EU |
| - | - | - | - | - |
| [`meta_ad_library`](https://docs.querying.ai/engines/meta-ad-library) | Facebook, Instagram, Messenger, WhatsApp, Threads | Every country | Running ads of any age. Stopped ads for about 1 year after they stop, if delivered in the EU or the UK. Ads on social issues, elections and politics for about 7 years | Reach by country, age and gender (also UK and Brazil), payer and beneficiary |
| [`google_ads_transparency`](https://docs.querying.ai/engines/google-ads-transparency) | Search, YouTube, Display, Play, Maps, Shopping | Every country | About 12 months after the last day an ad was shown | Impressions ranges for the ad, each country and each surface, and the first shown day per country |
| [`linkedin_ad_library`](https://docs.querying.ai/engines/linkedin-ad-library) | LinkedIn | Every country | About 12 months | Run dates, impressions range, share of impressions by country and targeting |
| [`tiktok_ad_library`](https://docs.querying.ai/engines/tiktok-ads) | TikTok | 34 regions: the EU and EEA countries, UK, Switzerland, Türkiye, Brazil | About 13 months | The library covers these regions only, and gives every ad its dates, impressions range, payer and targeting |
| [`tiktok_creative_center`](https://docs.querying.ai/engines/tiktok-ads) | TikTok top ads | 28 countries, including the US, Korea and Japan | The top ads of the last 7, 30 or 180 days | None. It gives the click-through rate, likes and cost level, and no dates or impressions |

## 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.

## Related

* [Meta Ad Library](https://docs.querying.ai/engines/meta-ad-library.md)
* [Google Ads Transparency](https://docs.querying.ai/engines/google-ads-transparency.md)
* [LinkedIn Ad Library](https://docs.querying.ai/engines/linkedin-ad-library.md)
* [TikTok Ads](https://docs.querying.ai/engines/tiktok-ads.md)
* [Engine overview](https://docs.querying.ai/engines/overview.md)
* [Credits and limits](https://docs.querying.ai/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.