Pricing

from $3.88 / 1,000 ads

Meta Ad Library Spy — Winning & Scaled Facebook Ads | $4/1K

Find competitors' WINNING ads, not just ads: is_scaled flags creatives Meta runs in 3+ variants (the advertiser is spending), plus days_active & longevity_score — the signals ad-spy tools charge $99/mo for. Full creatives, CTAs, landing pages. Token-free official Ad Library source. Pay per ad.

Pricing

from $3.88 / 1,000 ads

Rating

0.0

(0)

Developer

Vitalii Bondarev

Actor stats

Bookmarked

Total users

Monthly active users

2 days ago

Last modified

Categories

Marketing

Social media

MCP servers

You can access the Meta Ad Library Spy — Winning & Scaled Facebook Ads | $4/1K programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "KZsNLBjsNm0g8L6ii"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/bovi~meta-ads-library-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-bovi-meta-ads-library-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/bovi~meta-ads-library-scraper/runs": {
      "post": {
        "operationId": "runs-sync-bovi-meta-ads-library-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/bovi~meta-ads-library-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-bovi-meta-ads-library-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords to search ads for (e.g. 'nike', 'weight loss', 'crypto'). Each term runs as a separate query across every country. Leave empty if you only want advertiser page IDs.",
            "items": {
              "type": "string"
            }
          },
          "pageIds": {
            "title": "Advertiser page IDs",
            "type": "array",
            "description": "Numeric Facebook page IDs to pull ALL ads from a specific advertiser. Find a page ID in the Ad Library: open an advertiser and copy the numeric id from the URL. Works alongside or instead of search terms.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries (ISO codes)",
            "type": "array",
            "description": "Two-letter ISO country codes (e.g. US, GB, DE). The Ad Library requires a country; each is searched separately. Default: US.",
            "default": [
              "US"
            ],
            "items": {
              "type": "string"
            }
          },
          "adType": {
            "title": "Ad type / category",
            "enum": [
              "all",
              "political_and_issue_ads"
            ],
            "type": "string",
            "description": "all = commercial + everything; political_and_issue_ads = only political/issue ads, which additionally carry spend & impressions ranges.",
            "default": "all"
          },
          "activeStatus": {
            "title": "Active status",
            "enum": [
              "all",
              "active",
              "inactive"
            ],
            "type": "string",
            "description": "Filter ads by whether they are currently running. 'all' returns both active and inactive ads.",
            "default": "all"
          },
          "mediaType": {
            "title": "Media type",
            "enum": [
              "all",
              "image",
              "video",
              "meme",
              "none"
            ],
            "type": "string",
            "description": "Filter by creative format. 'all' keeps every format (image, video, carousel, text).",
            "default": "all"
          },
          "matchType": {
            "title": "Keyword match type",
            "enum": [
              "broad",
              "exact"
            ],
            "type": "string",
            "description": "broad = ads containing the words in any order; exact = the exact phrase. Applies to search-term queries only.",
            "default": "broad"
          },
          "maxResults": {
            "title": "Max ads per search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum ads to return per search term / page ID per country. The actor paginates automatically. Default 100. Keep low to control cost.",
            "default": 100
          },
          "pageSize": {
            "title": "Streaming batch size",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many ads to push per batch for real-time output. Lower = faster first results; higher = fewer dataset writes.",
            "default": 25
          },
          "docId": {
            "title": "Pagination doc_id (advanced — leave empty)",
            "type": "string",
            "description": "Meta's persisted-query id for the Ad Library pagination query. LEAVE EMPTY: the actor self-heals by re-extracting the live doc_id from each page, so it survives Meta's ~monthly rotation automatically. Only set this to force a specific id (overrides self-healing)."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy. RECOMMENDED on the cloud: Meta blocks datacenter IPs, so enable a RESIDENTIAL group for token-free scraping at volume. Billed to the run owner — no external proxy account needed.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Meta Ad Library Scraper — Spy Winning Facebook Ads OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Meta Ad Library Spy — Winning & Scaled Facebook Ads | $4/1K from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Meta Ad Library Spy — Winning & Scaled Facebook Ads | $4/1K API in Python

Meta Ad Library Spy — Winning & Scaled Facebook Ads | $4/1K API in JavaScript

Meta Ad Library Spy — Winning & Scaled Facebook Ads | $4/1K API through CLI

Meta Ad Library Spy — Winning & Scaled Facebook Ads | $4/1K API

Meta Ad Library Ads Scraper

adside/meta-ad-library-ads-scraper

Scrape active Meta Ad Library ads by Facebook page ID. Get ad creatives, copy, media, CTAs, landing URLs, dates & platforms for competitor research.

Adside

Meta Ad Library Scraper - Facebook & Instagram Ads

santhej/meta-ads-library-scraper

Scrape the Meta (Facebook & Instagram) Ad Library by keyword or advertiser. Get ad creatives, copy, CTA, run dates, days-running (winning-ad signal), platforms and landing links. No login.

Santhej Kallada

5.0

Meta Ad Library Scraper - Facebook Ad Spy, No Login

buff_pineapple/meta-ad-library-scraper

Scrape Facebook & Instagram ads from the Meta Ad Library — no login, no API key. Get ad creatives (HD/SD video + images), copy, CTAs, landing pages, advertiser details & political ad spend, across all countries and filters. Pay per ad, no monthly fee.

yossef Nagy

Meta Ad Spy

sentry/meta-ad-spy

Meta Ad Spy scrapes Facebook Ads Library to find winning products, dropshipping trends, and top Shopify ad angles. Discover long-running Meta ads, top CTAs, hooks, formats, and competitor creatives by keyword to validate products before you spend.

Sentry

Facebook Ad Library Spy — Meta Ads Competitive Intel

viralanalyzer/facebook-ads-library

Spy on any advertiser's Facebook & Instagram ads via Meta Ad Library. Get all active/inactive ads, creatives, formats, platforms, and AI-powered competitive analysis. Track competitor ad strategy, creative trends, and spend signals for marketing research.

viralanalyzer

415

4.7

Facebook Ads Library Scraper: Meta Ad Spy Tool

dltik/facebook-ads-scraper

Scrape Facebook & Instagram ads from Meta Ad Library by keyword, page or URL. Get ad copy, creatives, carousel cards, CTA links, EU spend, impressions, age/gender audience reach and running-days per ad. Filter by country, language, status. For ad spy, dropshipping, agencies. $0.75/1K ads.

Walid

5.0

Facebook Ads Library Scraper — Meta & Instagram Ad Spy

pro100chok/meta-ads-library-scraper

Facebook & Instagram ad spy. Scrape the Meta Ad Library by keyword, page, or ad archive ID. Extract creatives, ad copy, video URLs, landing pages, run dates, platforms, EU DSA disclosures, political-ad spend. All 240+ countries, all 6 ad categories. No Facebook login required.

Raven

Meta/Facebook Ads Library Scraper

alwaysprimedev/facebook-ads-library-scraper

Scrape ads, creatives, advertisers, and landing pages from the Facebook (Meta) Ad Library by keyword or advertiser — fast, structured JSON.

Always Prime

Meta Ads Library Scraper - Facebook & Instagram Ads No Login

groupoject/meta-ads-library-scraper-no-login

Scrape public Meta Ad Library ads from Facebook and Instagram without a Meta API token. Extract ad copy, page names, dates, landing domains, CTAs, links, and competitor ad examples.