Ad library tools
Search competitors' public ads across the Meta, Google and Microsoft ad libraries.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools1 tools
search_ad_library
קריאה2 creditsSearch competitors' ads in public ad libraries: Meta (Ad Library API; commercial ads only for EU/EEA/UK countries or ALL — any other country returns the official library link), Google (Ads Transparency data via DataForSEO), Microsoft (Microsoft Ad Library, EEA only). Returns advertiser, ad text, preview, start date / running days, reach when available and a link to the original record. LinkedIn and TikTok have no API we can use: returns the official library link with the query filled in. Results are cached for 15 minutes; nothing is invented.
| Parameter | Type | Description |
|---|---|---|
platformRequired | google | meta | linkedin | microsoft | tiktok | — |
queryRequired | string | brand, advertiser or keyword (a domain works best for google) |
countryOptional | string | two-letter country code or ALL (default ALL) |
mediaOptional | all | image | video | — |
statusOptional | active | all | — |
sortOptional | relevance | newest | longest_running | reach | — |
pageOptional | integer (1–10) | — |
regionOptional | string | alias of country |
limitOptional | integer (1–50) | at most this many ads from the page |