Retrieve Meta/Facebook ads for a company domain or Facebook page URL. Returns ad creatives, engagement metrics, and campaign details.
media_typestringFilter results by specific media format.
webhook_urlstringEndpoint URL to receive returned data via webhook.
country_codestringFilter results to a specific country using two-letter ISO country code (e.g., US, GB, FR).
facebook_urlstringFacebook page URL. Must start with https://. Either facebook_url or company_domain is required.
active_statusstringFilter by ad campaign status. Defaults to active ads only.
company_domainstringCompany website domain in 'company.com' format (no https:// or www. prefix). Either facebook_url or company_domain is required.
continuation_tokenstringToken for pagination to retrieve additional ad sets. Obtained from the initial response if more ads exist.
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
API key connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.