Ads Library Competitive Intelligence

Open Input (leave defaults → Start)

Paid first-run JSON ≈ Try Input: 1 public ad source + 1 creative ≈ USD 0.02/row. From USD 0.02/row. Paste a public ad-library URL and Start. Keep the first run bounded; this does not change the Actor's Store pricing. Open Console Input (deep link above) and run this JSON.

{
  "sourceUrls": [
    "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&q=example"
  ],
  "maxAdsPerSource": 1,
  "maxSources": 1,
  "dryRun": false,
  "__name": "ads-library-competitive-intelligence"
}

Store Quickstart

Run the bounded paid first-run JSON above first; keep report/export options off unless needed.

{
  "sourceUrls": [
    "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&q=example"
  ],
  "maxAdsPerSource": 1,
  "maxSources": 1,
  "dryRun": false,
  "__name": "ads-library-competitive-intelligence"
}

Use with Apify MCP

Exact actor: taroyamada/ads-library-competitive-intelligence

Direct-source v1 Actor for parsing user-provided public ad-library pages, export URLs, HTML snapshots, and saved HTML/export files.

Sample input JSON:

{
  "sourceUrls": [
    "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&q=example"
  ],
  "maxAdsPerSource": 3,
  "maxSources": 3
}

V1 scope

• Parses only direct sources supplied by the user.
• Supports public HTML, JSON, CSV, pasted HTML snapshots, and saved files inside the Actor working directory.
• Does not search, discover, crawl, paginate, log in, automate browsers, replay GraphQL/API calls, or bypass platform controls.
• High-risk platforms such as Meta, Google, LinkedIn, TikTok, and X are accepted only when the exact user-provided URL or snapshot looks like a public ad-library/export source.

Billing

Charged PPE events:

• ad_creative_profile for normalized ad creative rows.
• ad_library_partial for useful library-level evidence when no complete creative row is extracted.

No-charge diagnostic statuses:

• invalid
• blocked
• not_found
• not_ad_library
• error

Every dataset row includes status, chargedEvent, sourceUrls, and errors.

Local run

npm install
npm test
npm start

The included input.json uses dryRun: true and a small saved HTML snapshot.