Facebook ADS Report Scraper

Facebook Ads Report Scraper (Automated KPI & Spend Reports)

Automate Facebook Ads KPI reporting and advertiser spend tracking without any manual work.

This Apify actor generates scheduled Facebook Ads reports from public advertiser data and sends them directly to your inbox as a ZIP file.

Track spending, advertiser activity, regional distribution, and page-level insights in one automated workflow.

📊 Advertiser-Level Metrics

Page Name

Page ID

Disclaimer name

Total amount spent

Number of active ads

🌍 Regional Spend Distribution

Spend per region (state/country)

Regional ad budgets

Advertiser breakdown by location

📤 Automated Delivery

Email delivery of ZIP report

Scheduled report generation

Data-ready output for Excel / BI tools / dashboards

🔍 How it works

Configure date range and email recipients

Actor queries Facebook Ads Library reporting API

Computes advertiser and regional spend metrics

Generates report files

Sends ZIP file via email

Can be automated with Apify scheduling

Output

Advertisers

{
  "page_id": "24413227922",
  "page_name": "Kamala Harris",
  "disclaimer": "HARRIS FOR PRESIDENT",
  "amount_spent": "3067262",
  "number_of_ads_in_library": "5588"
}

Regions

{
  "total_location_name": "Alabama",
  "total_amount_spent": "199251"
}

Advertisers spending per Regions

{
  "split_page_id": "24413227922",
  "split_page_name": "Kamala Harris",
  "split_disclaimer": "HARRIS VICTORY FUND",
  "split_amount_spent": "14060",
  "split_region": "Alabama"
},
{
  "split_page_id": "24413227922",
  "split_page_name": "Kamala Harris",
  "split_disclaimer": "HARRIS VICTORY FUND",
  "split_amount_spent": "8447",
  "split_region": "Alaska"
},
...

Input

• date range: mandatory , default is last 7 days
• list receivers: emails you want to receive the report as zip
• limit: limit the storages to the first X results, sorted by spending
• Locations advertisers breakdown: True or False ("Advertisers spending per Regions" Object in Output section)
• Amount Spent per locations breakdown: True or False ("Regions" Object in Output section)

🧠 Use cases

Perfect for:

Marketing teams

Political campaign analysis

Ad transparency auditing

Spend monitoring

Market research

Competitor intelligence

Compliance reporting

Data journalism

🚀 Benefits

Fully automated reporting

Email delivery built-in

No code required

Works with Apify Schedules

Structured, clean output

Scales for enterprise monitoring

Easy export to Excel / Google Sheets

⚙️ Best practices

Use short date ranges for daily monitoring

Combine scheduling with filters for automation

Enable regional breakdowns for geo insights

Limit results to top spenders for faster reports

Keep email list lean for secure delivery

🛟 SUPPORT

Share your runs with the developer team and create issues on error to help us improve actor quality.

You might discover edge case we didn't test yet

We stay available anytime