API Reference

Meta Ad Library / API Reference

meta_ad_library_find_advertiser

Turn a brand name into the Facebook page_id that runs its ads. The reliable way in: keyword search misses any brand whose ad copy does not contain its own name, and page-scoped lookups do not. Returns the Pages found in the archive with how many of their ads matched, most first. Defaults to Ireland because the API only carries commercial ads for the EU/UK -- searching 'US' for a commercial brand finds nothing to resolve. Args: name: Brand or company name, e.g. 'Wix', 'Booking.com'. countries: Two-letter country codes, comma separated. Default 'IE'. limit: How many ads to scan for pages. Default 25. refresh: Skip the cache and ask Meta again.

This is a read-only tool: it returns ad library find advertiser for your Meta Ad Library account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Ad library find advertiser in my Meta Ad Library account for [name].

It takes 1 required and 3 optional parameters.

Parameters

ParameterTypeRequiredDescription
namestringYesName
countriesstringNoCountries
limitintegerNoLimit
refreshbooleanNoRefresh

Related Meta Ad Library tools

Start free — 30 tool calls a month

No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.