facebook_adLibrary_company_ads
Retrieves a company's Facebook Ad Library ads by page ID or company name, with filters for country, status, dates, language, media type and sort order. Returns paginated results with a cursor.
Instructions
facebookAdLibrary: Company Ads. GET /v1/facebook/adLibrary/company/ads. Provide one of: pageId, companyName. A company's ads from its Ad Library page, with the same filters as ad search. Returns results and a cursor. An empty page costs 0 credits, and an unknown companyName is a 404 at 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when results is empty. 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_company_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | The cursor from the previous page. Send it with the same filters. | |
| pageId | No | Ad Library page id, from /v1/facebook/adLibrary/search/companies. Provide pageId or companyName. | |
| status | No | Status of the ad. Defaults to ACTIVE. | |
| country | No | Where Facebook showed the ad: one two-letter country code, such as US, or ALL (default). Results can include advertisers from other countries whose ads reached it. | |
| sort_by | No | Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. | |
| end_date | No | Only ads with impressions on or before this date, YYYY-MM-DD. | |
| language | No | Only ads in this language: a two-letter code such as EN, ES or FR. | |
| media_type | No | Ad media type. Defaults to ALL. MEME means an image with text. | |
| start_date | No | Only ads with impressions on or after this date, YYYY-MM-DD. | |
| companyName | No | Company name, resolved to its Ad Library page (exact name first, else the top match). Provide companyName or pageId. |