Meta Ad Library / API Reference
meta_ad_library_advertiser_ads
List every archived ad for one Facebook Page. Takes the page_id from meta_ad_library_find_advertiser. This is the "what is this competitor running right now" call, and unlike a keyword search it does not depend on the brand naming itself in its own ad copy. Args: page_id: Facebook Page ID of the advertiser. countries: Two-letter country codes, comma separated. Default 'IE'. EU countries and 'GB' return commercial ads; elsewhere only political. ad_active_status: 'ACTIVE' (default), 'INACTIVE' or 'ALL'. limit: Max ads to return. Default 25. after: Paging cursor from a previous call's `after`. refresh: Skip the cache and ask Meta again.
This is a read-only tool: it returns ad library advertiser ads 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 advertiser ads in my Meta Ad Library account for [page id].
It takes 1 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | Page Id |
countries | string | No | Countries |
ad_active_status | string | No | Ad Active Status |
limit | integer | No | Limit |
after | string | No | After |
refresh | boolean | No | Refresh |
Related Meta Ad Library tools
meta_ad_library_ad_detailsmeta_ad_library_check_accessmeta_ad_library_creative_anglesmeta_ad_library_eu_reachmeta_ad_library_find_advertisermeta_ad_library_search_ads
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.