# Meta Ad Trend Finder (`deepmine/meta-ad-trend-finder`) Actor

Meta Ad Trend Finder scrapes Facebook Ads Library by keyword to uncover winning Meta ads, top hooks, headlines, CTAs, formats, and dominant advertisers. Rank ads by duration to spot battle-tested creatives and trending ad angles fast.

- **URL**: https://apify.com/deepmine/meta-ad-trend-finder.md
- **Developed by:** [DeepMine](https://apify.com/deepmine) (community)
- **Categories:** Social media, Lead generation, Other
- **Stats:** 14 total users, 1 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 Trend Finder - Facebook Ads Library Scraper for Winning Ad Trends, Hooks, CTAs, and Creative Research

Meta Ad Trend Finder is a keyword-based Meta ads research actor that analyzes public Facebook Ads Library data to help you find what ad creative is working right now.

Use it to discover winning ad hooks, headlines, call-to-action patterns, creative formats, and dominant advertisers across a niche, product category, or marketing angle.

This actor is designed for anyone searching for:

- Meta ad trends
- Facebook ad trends
- Meta ad creative research
- Facebook ad spy tool alternatives
- Winning Facebook ads by niche
- Meta ads competitor research
- Facebook ad hook finder
- Facebook Ads Library scraper

### Why This Meta Ads Library Tool Matters

Most Meta ad scrapers export a static list of current ads. Meta Ad Trend Finder is optimized for trend intelligence:

- It groups and summarizes ads by keyword query.
- It scores trend quality using ad duration signals.
- It highlights battle-tested ads versus fresh tests.
- It identifies recurring hooks and CTA patterns you can use for creative direction.

If you need faster Facebook ad research before launching campaigns, this actor gives you practical data, not just raw records.

### Core SEO Keyword Coverage

This project intentionally targets high-intent search terms buyers use when looking for Meta and Facebook ad research tools:

- Meta ad trend finder
- Facebook ad trend finder
- Meta ad creative intelligence
- Facebook ad competitor analysis
- Meta ad market research
- Facebook ad copy research
- Meta ad inspiration tool
- Facebook Ads Library data scraper
- Ad creative swipe file tool
- Best performing Facebook ads
- Long-running Meta ads
- High-converting ad hooks
- Meta ad CTA analysis
- Facebook ad format analysis

### What This Actor Does

For each search query (keyword, niche, or product theme), the actor:

1. Scrapes active ads from Meta/Facebook Ads Library.
2. Extracts ad-level creative fields (copy, headline, CTA, format, URLs, media links).
3. Calculates ad age in days.
4. Labels each ad by trend stage.
5. Builds query-level summaries with top hooks, top CTAs, top formats, and top advertisers.

### Trend Labels and Duration Logic

Ad duration is a practical proxy signal for creative viability:

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

Long-running ads are often retained because they keep producing acceptable performance for the advertiser.

### Input Parameters

- `searchQueries` (required): keyword list for niche discovery and trend analysis
- `country` (default `US`): ISO country code for Meta Ads Library scope
- `maxAdsPerQuery` (default `200`): cap for result depth per query
- `proxyConfiguration`: recommended residential proxy settings for stable pagination

### Output Data (Ad-Level)

The actor outputs ad-level records with key creative and intelligence fields:

- Query
- Advertiser / page name
- Ad archive ID
- Ad copy (body)
- Headline
- CTA
- Format
- Start date
- Ad age days
- Trend label
- Destination URL
- Image URL
- Video URL

### Output Data (Trend Summary)

Summary view includes one row per query with:

- Total active ads found
- Battle-tested count
- Gaining traction count
- New test count
- Average ad age
- Top CTA
- Top creative format
- Top advertisers by ad count
- Top hook snippets
- Longest-running ad signal

### Who Uses Meta Ad Trend Finder

- Performance marketing teams
- Paid social media buyers
- DTC and ecommerce brands
- Growth agencies
- Creative strategists
- Copywriters building new messaging angles
- Founders validating paid demand in a category

### High-Intent Use Cases

- Find proven Facebook ad hooks before writing new ads.
- Research Meta ad creative styles in a new niche.
- Compare CTA patterns by market segment.
- Build an ad swipe file from long-running campaigns.
- Identify dominant advertisers in a keyword cluster.
- Validate product demand using active ad volume and ad longevity.

### Meta Ad Trend Finder vs Typical Facebook Ad Scrapers

Typical Meta ad scraper output:

- One-time raw ad dump
- Minimal trend context

Meta Ad Trend Finder output:

- Query-driven trend analysis
- Duration-based quality signals
- Creative pattern summaries
- Faster strategic decisions for ad testing

### Frequently Searched Questions This Actor Helps Answer

- What ads are working on Facebook right now?
- How do I find winning Meta ad creatives in my niche?
- Which Facebook ad hooks are most common in my market?
- What CTA performs most often in competitor ads?
- How do I scrape Facebook Ads Library by keyword?
- Which advertisers dominate Meta ads for my product category?

### Practical Workflow for Better Results

1. Start with 3-10 narrow search queries (not broad one-word terms).
2. Run in your target country first, then expand to more markets.
3. Compare top hooks and top CTAs across multiple related queries.
4. Prioritize battle-tested ads when building first-round concepts.
5. Use gaining-traction ads to spot emerging creative shifts.

### Data Source and Compliance

- Source: Meta/Facebook Ads Library (public transparency database)
- No login required
- Intended for competitive research, creative intelligence, and market analysis

### Related Search Intent Phrases

Meta ad research tool, Facebook ads research tool, Meta ad spy software, Facebook ad intelligence tool, Meta creative research, competitor ad tracking, ad trend analysis tool, Facebook ad copy analyzer, Meta ad market scanner, best Facebook ad examples.

# Actor input Schema

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

Keywords, niches, or product categories to scan in the Meta Ads Library. One query per line.

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

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

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

Maximum number of ads to collect per search 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

## `summary` (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-trend-finder").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-trend-finder").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-trend-finder --silent --output-dataset

```

## MCP server setup

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

```

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/F8wyT8sfIJqK0resW/builds/I6WDR9qb1Dvr1BRmI/openapi.json