# Meta Ad Intelligence (`deepmine/meta-ad-intelligence`) Actor

Meta Ad Intelligence scrapes Facebook Ads Library to discover who is advertising in your niche, rank competitors by dominance score and share of voice, flag new entrants, and reveal top ad formats, CTAs, hooks, and creative trends for market research.

- **URL**: https://apify.com/deepmine/meta-ad-intelligence.md
- **Developed by:** [DeepMine](https://apify.com/deepmine) (community)
- **Categories:** Social media, Lead generation, Other
- **Stats:** 8 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$25.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Meta Ad Intelligence - Facebook Ads Library Scraper for Competitor Discovery, Share of Voice, and Meta Ad Market Research

Meta Ad Intelligence is an advanced **Facebook Ads Library scraper** and **Meta competitor intelligence tool** for discovering who is advertising in your market, how dominant each advertiser is, and what creative patterns drive sustained activity.

This actor is built for users searching for:

- Meta ad intelligence
- Facebook ad market research
- who is advertising on Facebook in my niche
- Meta ad competitor discovery
- Facebook ad share of voice analysis
- Meta ad landscape scanner
- paid social competitor analysis

If your goal is **market-level competitive intelligence** instead of tracking one known competitor, this actor is the right tool.

### Table of Contents

1. What Is Meta Ad Intelligence
2. Why This Actor Exists
3. Who Should Use It
4. Core Features
5. Intelligence Metrics Explained
6. Inputs
7. Outputs and Views
8. Practical Workflows
9. SEO and Search-Intent Use Cases
10. FAQ
11. Data Source and Notes

### 1) What Is Meta Ad Intelligence

Meta Ad Intelligence maps the competitive ad landscape for a keyword, product category, or niche using public Meta/Facebook Ads Library data.

Instead of returning only raw ad rows, it produces three intelligence layers:

- **Market Summary**: overall market structure for each query
- **Advertiser Rankings**: dominance and share of voice by advertiser
- **Ad-Level Records**: complete creative-level detail for deeper analysis

This gives you both strategic and tactical visibility in one run.

### 2) Why This Actor Exists

Most Facebook ad tools do one of these:

- dump current ads with no market context
- track specific known competitors only
- focus on creative inspiration without market concentration metrics

Meta Ad Intelligence solves the missing layer: **Who controls ad attention in this market right now?**

It helps you answer:

- Who are the top advertisers in this niche?
- Is this market concentrated or fragmented?
- Are new entrants appearing and scaling?
- Which CTA and format patterns dominate category leaders?

### 3) Who Should Use It

#### Agencies and media buyers

Use it for pre-campaign market audits and client strategy decks with real competitive context.

#### Ecommerce brands and DTC teams

Validate category competitiveness before committing paid budget.

#### Growth teams and founders

Assess paid social intensity in a niche before product launch or channel expansion.

#### Investors and operators

Track whether startups or categories are scaling aggressively on Meta ads.

### 4) Core Features

#### Query-based market discovery

Input one or many niche keywords and discover active advertisers per query.

#### Advertiser ranking engine

Each advertiser is ranked by ad volume, age profile, and dominance score.

#### Share of voice estimation

Quantifies each advertiser's share of total visible ad activity for the query.

#### New entrant detection

Flags advertisers with recent-age profiles to help identify emerging competitors.

#### Creative pattern extraction

Surfaces top CTA patterns, top formats, and hook snippets at market level.

#### Structured output views

Dedicated dataset views for market summary, advertiser rankings, and ads.

### 5) Intelligence Metrics Explained

#### Dominance Score

`dominanceScore = advertiserAdCount x advertiserAvgAdAgeDays`

Why it matters:

- High ad count alone can indicate testing breadth.
- High average age alone can indicate message durability.
- Multiplying both helps identify advertisers with both scale and sustained activity.

#### Share of Voice Percentage

`shareOfVoicePct = advertiserAdCount / totalAdsForQuery * 100`

Why it matters:

- Approximates how much visible ad presence each advertiser owns in the result set.
- Helps detect concentrated markets vs fragmented markets.

#### New Entrant Flag

`isNewEntrant = true` when advertiser age profile is recent.

Why it matters:

- Useful for spotting emerging competitors before they become obvious incumbents.

#### Trend Mix (Market Structure)

- `Battle-tested`: 30+ days
- `Gaining traction`: 14-30 days
- `New test`: under 14 days

Why it matters:

- Quick snapshot of whether the niche has stable proven campaigns or rapid testing churn.

### 6) Inputs

- `searchQueries` (required): keywords, categories, niche phrases
- `country` (default `US`): geographic scope (ISO 2-letter code)
- `maxAdsPerQuery` (default `200`): retrieval depth per query
- `proxyConfiguration`: residential proxy recommended for reliability

#### Input examples

- `running shoes`
- `email marketing software`
- `home gym equipment`
- `supplements for runners`
- `wedding photographer`

Tip: Specific long-tail queries usually produce better competitive segmentation than broad single-word terms.

### 7) Outputs and Views

#### View A: Market Summary

One row per query with strategic market signals:

- total ads
- total advertisers
- battle-tested / gaining / new counts
- average ad age
- top advertiser
- top advertiser share of voice
- top dominance score
- top format
- top CTA
- top advertisers list
- top hooks list

#### View B: Advertiser Rankings

One row per advertiser per query:

- advertiser name
- ad count
- average ad age
- dominance score
- share of voice %
- new entrant flag
- top format (advertiser level)
- top CTA (advertiser level)

#### View C: Ads

Ad-level records for creative and landing-page analysis:

- query
- advertiser
- ad age
- trend label
- ad ID
- body text
- headline
- CTA
- format
- page name
- start date
- destination URL
- image URL
- video URL

### 8) Practical Workflows

#### Workflow 1: Market entry check

1. Add 5-10 category queries.
2. Run actor for target country.
3. Review Market Summary for concentration and top advertiser share.
4. Review Advertiser Rankings for dominance tiers.
5. Decide whether niche is open, crowded, or concentrated.

#### Workflow 2: Competitor discovery sprint

1. Start with one core product keyword.
2. Expand with adjacent intent terms.
3. Export advertiser rankings.
4. Build shortlist of top competitors for deeper monitoring.

#### Workflow 3: Creative strategy + market context

1. Pull advertiser rankings for niche.
2. Open Ads view for top 3-5 advertisers.
3. Compare format and CTA distribution.
4. Build test plan from battle-tested vs gaining-traction patterns.

#### Workflow 4: Agency client audit

1. Run actor across client category terms.
2. Package market summary + rankings in a report.
3. Present share-of-voice map and creative pattern findings.
4. Use insights to justify media and creative strategy decisions.

### 9) SEO and Search-Intent Use Cases

This actor is aligned with real search intent behind phrases such as:

- "how to find competitors advertising on Facebook"
- "facebook ads competitor analysis tool"
- "meta ads market research software"
- "facebook ad share of voice"
- "who advertises most on meta ads"
- "meta ad landscape analysis"
- "paid social competitive intelligence"

Because the outputs are structured, it can support:

- strategy reports
- ad intelligence dashboards
- outbound prospecting intelligence
- vertical opportunity assessment

### 10) FAQ

#### Is this a Facebook Ad Spy tool?

Yes. In practice it works as a **Facebook ad spy and competitor discovery tool**, but with stronger market-level intelligence metrics.

#### Does it require Facebook login?

No. It uses public Meta/Facebook Ads Library data.

#### Is this for one competitor or whole market discovery?

Whole market discovery. Input keywords, and it discovers advertisers for you.

#### How is this different from Meta Ad Trend Finder?

Trend Finder prioritizes creative trend patterns by query. Meta Ad Intelligence prioritizes advertiser discovery, dominance ranking, and market structure.

#### What is the difference between ad count and dominance score?

Ad count shows volume only. Dominance score combines volume and durability (age).

#### Can I use this for agency lead research?

Yes. It is useful for identifying active advertisers by niche and prioritizing outreach targets.

#### What countries are supported?

Any country supported by Meta Ads Library country parameter.

### 11) Data Source and Notes

- Source: Meta/Facebook Ads Library (public transparency data)
- No login required
- Residential proxies recommended for stable pagination
- Results quality depends on query specificity and current ad library availability

### Related SEO Phrases

Meta competitive intelligence tool, Facebook competitor ad tracker, Meta ad market scanner, Facebook advertising landscape tool, paid social market intelligence, advertiser discovery software, Facebook Ads Library analytics, Meta ads intelligence platform, social ad competitor research, ad market share analysis.

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords, product categories, or market terms to discover active advertisers.

## `country` (type: `string`):

Country to search ads for (ISO 2-letter code).

## `maxAdsPerQuery` (type: `integer`):

Maximum number of ads to collect per query.

## `proxyConfiguration` (type: `object`):

Residential proxies are recommended for stable Meta pagination.

## Actor input object example

```json
{
  "searchQueries": [
    "running shoes",
    "protein powder"
  ],
  "country": "US",
  "maxAdsPerQuery": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `market` (type: `string`):

No description

## `advertisers` (type: `string`):

No description

## `ads` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "running shoes",
        "protein powder"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepmine/meta-ad-intelligence").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQueries": [
        "running shoes",
        "protein powder",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("deepmine/meta-ad-intelligence").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "running shoes",
    "protein powder"
  ]
}' |
apify call deepmine/meta-ad-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/meta-ad-intelligence"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ek9y54d5g5kCMYcIR/builds/hflyQZQhajtxVSHEf/openapi.json