🔗 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-parser --input input.json

Step 4: Get Results

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

---

---

⚠️ Important: Execution Model & Costs

This Actor is a URL-based wrapper around the Facebook Ad Library.

When you run Facebook Ads Url Parser, it does not scrape ads directly. Instead:

• The Actor parses the provided Facebook Ad Library URL
• It then executes Facebook Ads Scraper Pro in standby mode
• The scraper performs the actual data extraction and returns results to this Actor

What this means

• You may see two Actors running for a single execution
• This is expected behavior
• The Actor does not run automatically and is only triggered when you start it manually
• The standby execution consumes compute units, just like running the scraper directly

Billing & Compute Usage

• Running this Actor is not free
• Costs are generated by the internally executed scraper
• Charges apply even though no additional configuration is required

If you prefer full control over parameters and execution, you can 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 uses a standby Actor execution to ensure consistent output and feature parity with the main scraper. 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
• ✅ 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: flowextractapi@outlook.com
• 🙋 Apify Profile: dz_omar
• 💬 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

---