Facebook Ad Library Company Ads
social_facebook_ad_library_company_adsFetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body, images, videos, and display_format. Supports filtering by country, media_type, date range, and language with cursor-based pagination. Both GET and POST are supported. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Ad Library Company Ads API View Pricing Get a company's running ads. Use GET normally; for long pagination cursors, use POST with the same parameters in the JSON body. 1 credit per request GET /v1/facebook/adLibrary/company/ads Actual supplier units are reported per request. Examples are not guaranteed prices.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trim | No | Set to true for a trimmed down version of the response | |
| cursor | No | Cursor to paginate through results | |
| pageId | No | The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName | |
| status | No | Status of the ad. Defaults to ACTIVE. | |
| country | No | This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL. | |
| sort_by | No | Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. | |
| end_date | No | End date to search for. Format: YYYY-MM-DD | |
| language | No | Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc | |
| media_type | No | Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme. | |
| start_date | No | Start date to search for. Format: YYYY-MM-DD | |
| companyName | No | The name of the company. Can either use this or pageId |