Skip to content

README.md

Latest commit

 

History

History
260 lines (186 loc) · 7.26 KB

README.md

File metadata and controls

260 lines (186 loc) · 7.26 KB
Raw

🔗 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

🤝 Support & Resources

📞 Support

Get Help

Social Media

🌟 Related Actors by FlowExtract API

🎬 Video & Media

🏠 Real Estate

🛠️ Developer Tools

📱 Social Media

⚖️ 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