facebook-ads-library-search

Extracts ad creatives, copy, and metrics from Meta Ad Library by keyword or page ID.

5.5k|269|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/browser-act/skills --skill facebook-ads-library-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: facebook-ads-library-search
Source: https://github.com/browser-act/skills/tree/main/solutions/social-listening/facebook-ads-library-search
Command: npx skills add https://github.com/browser-act/skills --skill facebook-ads-library-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually browsing Meta Ad Library to research competitor ads, monitor brand advertising, or audit political and housing ads is slow and hard to scale. This Skill automates searching the Meta Ad Library and returns structured ad data including creatives, copy, CTA, platforms, and spend estimates.

Core Features & Use Cases

  • Keyword and Page Search: Search ads by keyword or pull all ads from a specific Facebook page ID, with filters for country, active status, ad type, media type, and publisher platform.
  • Structured Ad Data: Returns ad archive ID, page info, body text, title, CTA, link URL, images, videos, carousel cards, and spend/impression/reach estimates where disclosed.
  • Cursor Pagination: Iterate through large result sets using end_cursor and has_next_page for batch collection.
  • Use Case: A marketing analyst wants to monitor a competitor's active Instagram and Facebook ads. They provide the competitor's page ID and receive a structured list of all running ads with creatives and copy for competitive analysis.

Quick Start

Search Meta Ad Library for active ads matching the keyword 'running shoes' in the US and list the top 10 results with their creatives and copy.

Frequently Asked Questions about facebook-ads-library-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Facebook Ad Library by keyword?

Run the search-ads script with the --query parameter and optional filters like --country and --active-status. It returns a JSON list of ads with body text, title, CTA, creatives, and publisher platforms, plus a cursor for pagination.

How to get all ads from a specific Facebook page?

Use the --page-id parameter with the advertiser's Facebook page ID instead of a keyword query. The page ID appears in the page URL or its About section, and the response includes every ad that page runs across Meta platforms.

Does Meta Ad Library search require a Facebook login?

No login is required for this capability. The browser only needs to be open on any facebook.com page so the script can obtain the LSD token needed to call the Ad Library GraphQL endpoint.

Why are spend and impression fields null for some ads?

Meta only discloses spend, impressions, and reach estimates for political and social issue ads or at its own discretion. For standard commercial ads these fields are frequently null, while ad_archive_id remains the reliable unique identifier.

What are the limitations of scraping Meta Ad Library?

High-frequency requests can trigger rate limiting, so batch scripts should add 1-2 second delays between calls. Private or restricted ads may not appear, and the compiled doc_id query identifier can change when Meta updates its frontend.