🔗 Facebook Ads URL Parser is a ready-to-run Apify actor from FlowExtract API for advertising intelligence. Copy any Facebook Ad Library URL and get instant ad data - No configuration needed. This page explains what it does, who it's for, and how to get the most out of it — then includes the full technical documentation below.

Use cases

the Actor parses the provided Facebook Ad Library URL
it then executes [Facebook Ads Scraper Pro](https://apify.com/dzomar/facebook-ads-scraper-pro?fpr=smcx63) in standby mode
the scraper performs the actual data extraction and returns results to this Actor
you may see two Actors running for a single execution

Frequently asked questions

How do I run 🔗 Facebook Ads URL Parser?

Open 🔗 Facebook Ads URL Parser on the Apify Store, provide your input (URLs or search parameters), and click Start. Results are available as JSON, CSV, or Excel, and via the Apify API.

Is 🔗 Facebook Ads URL Parser free?

🔗 Facebook Ads URL Parser runs on Apify's pay-as-you-go platform; you only pay for the compute/usage a run consumes. Check the actor page for current pricing and any free tier.

Documentation

🔗 Facebook Ads URL Parser

Copy any Facebook Ad Library URL and get instant ad data - No configuration needed.

Copy URL → Get Results → Done

🚀 Quick Start

Step 1: Copy URL from Facebook

Open Facebook Ad Library, use any filters you want, then copy the URL from your browser address bar.

Example URL:

https://www.facebook.com/ads/library/?q=nike&country=US&active_status=active&...

Step 2: Create Input

Save your URL to input.json:

{
  "URLAds": [
    {
      "url": "https://www.facebook.com/ads/library/?q=nike&country=US&..."
    }
  ],
  "maxResultsPerURL": 200
}

Step 3: Run Actor

apify call dz_omar/facebook-ads-url --input input.json

Step 4: Get Results

Results appear in your dataset - same format as - facebook-ads-scraper-pro!

⚠️ Important: This Actor Runs Facebook Ads Scraper Pro — and You Are Charged for It

This Actor is a URL-based wrapper. It does not scrape ads itself.

When you run Facebook Ads URL Parser:

It starts Facebook Ads Scraper Pro in your own Apify account, passing it your URLs
Facebook Ads Scraper Pro reads the filters from each URL and scrapes the ads
Every ad is copied into this Actor's dataset as soon as it is scraped — you don't have to wait for the run to finish

💳 Billing — please read

Facebook Ads Scraper Pro is a paid, pay-per-event Actor. Every run of this Actor starts a Facebook Ads Scraper Pro run, and you are charged Facebook Ads Scraper Pro's prices (a small start fee plus a fee per ad scraped) — exactly as if you had run it yourself
See the current prices on the Facebook Ads Scraper Pro pricing tab
This Actor adds no extra fee of its own — you only pay for the ads Facebook Ads Scraper Pro collects, plus the usual platform usage of both runs
maxResultsPerURL controls how many ads (and so how many charges) each URL can produce
Apify free-plan accounts get a sample of up to 200 results per run (a Facebook Ads Scraper Pro limit)

What you will see in your account

Two runs for each execution: this one, and the Facebook Ads Scraper Pro run it started. This is expected
The log of this run links to the Facebook Ads Scraper Pro run so you can watch it live
Aborting this run also aborts the Facebook Ads Scraper Pro run, so charges stop
Nothing runs automatically — Facebook Ads Scraper Pro only starts when you start this Actor

If you prefer full control over parameters (keywords, advertisers, ad-detail enrichment), run the scraper directly:

👉 Facebook Ads Scraper Pro

When to Use This Actor

Use Facebook Ads URL Parser if you want to:

Re-run saved Facebook Ad Library URLs
Automate competitor monitoring using copied URLs
Avoid manually configuring search parameters

Use Facebook Ads Scraper Pro if you want:

Direct parameter-based control
Clear visibility into compute usage per run
Advanced scraping options

✅ Transparency Notice

This Actor intentionally runs Facebook Ads Scraper Pro in your account to ensure consistent output and feature parity with the main scraper, and that run is billed to you at Facebook Ads Scraper Pro's prices. This behavior is by design and not an automatic or hidden trigger.

📋 Input Format

That's it. Just two fields:

Field	Type	Required	Description
`URLAds`	array	✅ Yes	Array of Facebook Ad Library URLs
`maxResultsPerURL`	integer	❌ No	Max ads per URL (default: 10, range: 10-∞)

Example

Multiple URLs:

{
  "URLAds": [
    {"url": "https://www.facebook.com/ads/library/?q=nike&..."},
    {"url": "https://www.facebook.com/ads/library/?q=adidas&..."},
    {"url": "https://www.facebook.com/ads/library/?search_type=page&view_all_page_id=12345&..."}
  ],
  "maxResultsPerURL": 10
}

With Custom Limit:

{
  "URLAds": [
    {"url": "https://www.facebook.com/ads/library/?..."}
  ],
  "maxResultsPerURL": 500
}

📤 Output

You get the exact same ad data as the main scraper:

{
  "id": "1234567890",
  "page_name": "Nike",
  "page_likes": 5000000,
  "text": "Just Do It",
  "title": "Campaign Title",
  "start_date": "2024-01-15",
  "is_active": true,
  "media": {
    "type": "image",
    "primary_thumbnail": "https://..."
  },
  ...
}

Each ad is one item in your dataset.

💡 Common Scenarios

Monitor Competitor Ads

Copy the URL after searching for your competitor:

{
  "URLAds": [
    {"url": "https://www.facebook.com/ads/library/?q=competitor_brand&..."}
  ]
}

Track Specific Brand

Copy the URL after selecting a page:

{
  "URLAds": [
    {"url": "https://www.facebook.com/ads/library/?search_type=page&view_all_page_id=15087023444&..."}
  ]
}

Analyze Multiple Regions

Copy URLs from different countries:

{
  "URLAds": [
    {"url": "https://www.facebook.com/ads/library/?q=nike&country=US&..."},
    {"url": "https://www.facebook.com/ads/library/?q=nike&country=GB&..."},
    {"url": "https://www.facebook.com/ads/library/?q=nike&country=DE&..."}
  ],
  "maxResultsPerURL": 100
}

✅ Supported URLs

✅ Keyword search URLs
✅ Advertiser/page search URLs
✅ Date-filtered URLs
✅ Country/language-filtered URLs
✅ Platform-filtered URLs
✅ Single ad links (https://www.facebook.com/ads/library/?id=...)
✅ Any Facebook Ad Library URL

🔗 Related Actors

facebook-ads-scraper-pro - Direct search using parameters (advanced)

🤝 Support & Resources

📞 Support

Get Help

🌐 Website: flowextractapi.com
📧 Email: [email protected]
🙋 Apify Profile: FlowExtract API
💬 GitHub Issues: FlowExtractAPI

Social Media

💼 LinkedIn: flowextract-api
🐦 Twitter: @FlowExtractAPI
📱 Facebook: flowextractapi

🌟 Related Actors by FlowExtract API

🎬 Video & Media

YouTube Transcript Extractor - Extract transcripts with timestamps
YouTube Scraper Pro - Complete channel and playlist extraction
Zoom Scraper - Download recordings and transcripts
Loom Scraper - Loom video and transcript extraction

🏠 Real Estate

Idealista Scraper API - Spanish property data with API
Idealista Scraper - Real estate listings extractor

🛠️ Developer Tools

Screenshot - Fast webpage screenshots
Ultimate Screenshot - Advanced screenshot tool
Network Security Scanner - Security vulnerability scanner

📱 Social Media

Facebook Ads Scraper Pro - Extract Facebook ads data

⚖️ Legal & Compliance

Public Data Access: Only processes publicly available Facebook Ad Library data
Rate Limiting: Respects Facebook's service limits and terms of use
Data Protection: No storage of personal information or unauthorized data collection
Commercial Use: Suitable for business intelligence and research applications