facebook_adLibrary_ad
Retrieves details for a Facebook Ad Library ad by Library ID or ads/library URL, including status, dates, page info, creative snapshot, and EU audience data.
Instructions
facebookAdLibrary: Ad Details. GET /v1/facebook/adLibrary/ad. Get one Facebook Ad Library ad by its Library ID or ads/library/?id= URL, active or inactive. Returns adArchiveID, pageName, isActive, startDate, endDate, publisherPlatform and the snapshot (body, cards, images, videos, display_format, link_url, cta_text), with the advertiser's pageInfo and, for ads shown in the EU, aaa_info audience data. An ad no longer in the library is a 404. Ids are strings. Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "facebook_adLibrary_ad"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Facebook Ad Id | |
| url | No | Facebook Ad Library URL, e.g. https://www.facebook.com/ads/library/?id=1016451784037642 | |
| trim | No | Set true for a trimmed response. | |
| cache_max_age | No | Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price. | |
| get_transcript | No | Not supported: get_transcript=true returns 400. Use the video URLs in snapshot.videos. | |
| allow_long_transcription | No | Accepted for compatibility and ignored. |