🔗 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!

---

📋 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

---