API Reference

Meta Ad Library / API Reference

meta_ad_library_creative_angles

Meta Ad Library tool. Summarise the angles one advertiser is running on Facebook and Instagram. The analysis tool: which headlines and calls to action they repeat, which ads have run longest, how their ads split across Facebook and Instagram, and how much is still live. Use this to answer "what is their pitch" rather than listing fifty near-identical creatives. Args: page_id: Facebook Page ID, from meta_ad_library_find_advertiser. countries: Two-letter country codes, comma separated. Default 'IE'. limit: How many ads to analyse, up to 100. Default 100. refresh: Skip the cache and ask Meta again.

This is a read-only tool: it returns ad library creative angles 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 creative angles in my Meta Ad Library account for [page id].

It takes 1 required and 3 optional parameters.

Parameters

ParameterTypeRequiredDescription
page_idstringYesPage Id
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.