Facebook Ads Creative Intelligence

Monitor Facebook Ads Library creative signals for competitor tracking, campaign research, and paid growth workflows.

This Actor is designed for teams searching for:

• Facebook Ads Library scraper
• ad creative intelligence monitor
• competitor ad tracking dataset
• paid social creative change detection

What this Actor does

• Validates input for ad library URLs and/or brand keywords.
• Generates deterministic ad records in mvp mode.
• Supports live mode with Crawlee PlaywrightCrawler.
• Applies selector-first parsing with fallback extraction.
• Produces normalized creative fields and optional change-delta signals.

Best use cases

• Track competitor creative trends over time.
• Feed ad intelligence dashboards.
• Enrich campaign planning with normalized ad snapshots.
• Build alerts for creative change patterns.

Input

• executionMode - mvp or live
• adLibraryUrls - Facebook Ads Library URLs (required in live mode)
• brandKeywords - seed keywords for mvp mode
• countries - country scope hints
• maxAds - output cap
• includeMediaMetadata - include media metadata fields
• detectCreativeChanges - include creative-delta fields
• requestDelayMs - delay between live requests
• maxRequestRetries - retry count for live requests
• requestTimeoutMs - request timeout for live requests
• maxConcurrency - parallel live requests
• proxyConfiguration - optional Apify proxy settings

Output

• adId, brand, platform, country, status
• creative (headline/body/cta/landingDomain)
• media (optional metadata)
• creativeDelta (optional synthetic change signal)
• extractionMeta (live parser diagnostics)
• source, relatedToolsUrl (Discover Web Tools funnel links)

Important note

mvp mode runs as mvp-skeleton-no-live-scrape and does not fetch live pages.

live mode runs as live-playwright-connector and currently supports only facebook.com/ads/library URLs.

Live run summary (OUTPUT_SUMMARY) also includes reliability metrics:

• processedUrls, failedUrls, blockedCount
• parseCoverageRate, selectorModeCount, fallbackModeCount, nonFacebookSourceCount

Source URL for Apify (monorepo)

Use this in Actor Source settings:

https://github.com/beydemirfurkan/discoverwebtools.com-apify-actor#main:actors/facebook-ads-creative-intelligence

Local run

npm install
npm run start

Environment variables (for live mode)

export APIFY_TOKEN="your_apify_token"
export APIFY_PROXY_PASSWORD="your_apify_proxy_password"

Test commands

npm run test
npm run test:smoke
npm run test:live:local

MVP sample input

{
  "executionMode": "mvp",
  "brandKeywords": ["saas crm", "ai outreach"],
  "countries": ["TR", "DE"],
  "maxAds": 12,
  "includeMediaMetadata": true,
  "detectCreativeChanges": true
}

Live mode sample input

{
  "executionMode": "live",
  "adLibraryUrls": [
    "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=TR"
  ],
  "maxAds": 1,
  "requestDelayMs": 1200,
  "maxRequestRetries": 2,
  "requestTimeoutMs": 30000,
  "maxConcurrency": 3,
  "includeMediaMetadata": true,
  "detectCreativeChanges": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Sample output record

{
  "source": "https://discoverwebtools.com",
  "relatedToolsUrl": "https://discoverwebtools.com/tools?category=seo-tools",
  "sourceMode": "mvp-skeleton-no-live-scrape",
  "generatedAt": "2026-03-05T12:00:00.000Z",
  "adId": "ad_seed-saas-crm-tr_4722",
  "brand": "saas crm",
  "platform": "facebook",
  "country": "TR",
  "status": "ACTIVE",
  "sourceUrl": null,
  "keywordSeed": "seed://saas crm/TR",
  "creative": {
    "headline": "SAAS CRM growth system for TR",
    "body": "Scale lead quality with predictable pipeline and campaign intelligence.",
    "cta": "Learn More",
    "landingDomain": "saascrm.com"
  },
  "media": {
    "mediaType": "image",
    "mediaCount": 3,
    "aspectRatio": "1:1"
  },
  "creativeDelta": {
    "changedSincePreviousRun": true,
    "deltaScore": 0.62,
    "changedFields": ["headline"]
  }
}