Facebook Ad Library Brand Finder – Resolve Page IDs, Verification & Instagram Links | Apify Actor

Facebook Ad Library Brand Finder turns any brand name into a ranked list of matching Facebook/Meta Pages from the Meta Ad Library typeahead — with Page IDs, verification badges, follower counts, category, and linked Instagram handles.

Use with Apify AI

Apify AI is live in Apify Console. Describe the job in plain English and it finds this Actor, fills the input form, runs it, and returns the dataset. The same ranking powers Store search and the Apify MCP server search-actors tool used by Cursor, Claude, ChatGPT, and other agents.

Use this Actor to resolve a brand name to Facebook Page IDs before scraping ads. Open Meta Brand Finder or ask Apify AI with the prompts below.

Prompts that match this Actor

Type these in the Apify Store search bar (long, intent-heavy queries route to Apify AI) or the dashboard Ask Apify AI widget:

• "Find the Facebook Page ID for Nike"
• "Resolve a brand name to Meta Page IDs with likes and Instagram handle"
• "Look up Facebook page IDs I can pass into an Ad Library scraper"
• "Search Meta Ad Library suggestions for Adidas"
• "Get verified Facebook page candidates for a brand"

How Apify AI fills the input

You say	This Actor sets
brand name	brand_name

Apify AI always asks for confirmation before it runs. Nothing is charged until you approve.

Cursor, Claude, ChatGPT (Apify MCP)

Pin this Actor as a default Cursor / MCP tool so agents call scrapeio/facebook-ad-library-suggestions instead of a random Store result. Keep actors + docs so Apify AI search still works, and list your suite so Cursor prefers these Actors.

Cursor MCP URL (this Actor first):

https://mcp.apify.com?tools=actors,docs,scrapeio/facebook-ad-library-suggestions,scrapeio/amazon-scraper,scrapeio/google-maps-scraper-advance,scrapeio/meta-facebook-ad-scrapper-using-ad-library-url-premium,scrapeio/instagram-scraper-premium,scrapeio/whatsapp-scraper-premium,scrapeio/google-news-scraper

.cursor/mcp.json / Cursor Settings → MCP:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=actors,docs,scrapeio/facebook-ad-library-suggestions,scrapeio/amazon-scraper,scrapeio/google-maps-scraper-advance,scrapeio/meta-facebook-ad-scrapper-using-ad-library-url-premium,scrapeio/instagram-scraper-premium,scrapeio/whatsapp-scraper-premium,scrapeio/google-news-scraper"
    }
  }
}

Then: search-actors → fetch-actor-details → call-actor with scrapeio/facebook-ad-library-suggestions. Example:

Use scrapeio/facebook-ad-library-suggestions to do this: scrape the data I described. Fill the input from my description and return the dataset.

How to find Facebook Page IDs from a brand name

Use this Meta brand finder to turn a brand name into Facebook Page IDs for Ad Library scrapes.

Facebook Page ID finder API for Cursor

Call scrapeio/facebook-ad-library-suggestions from Cursor (Apify MCP), Claude, ChatGPT, the Apify API, Python (apify-client), or JavaScript. Apify AI uses the same ranking as Store search: title, description, README, and input/output schemas. This Actor is documented for that ranker — limited permissions, pay-per-event or compute (not rental), and a filled example input.

🧠 Overview

This Facebook Ad Library Brand Finder is a lightweight Apify Actor for ad researchers, agencies, sales teams, and analysts who need to resolve brand names to official Facebook Page IDs before running deeper Ad Library scrapers. Type a string like Nike or Apple and the Actor calls Meta's public GraphQL typeahead endpoint (the same one powering the Ad Library search bar), parses every matching page, and returns Page ID, display name, category, avatar URL, likes, verification status, page alias, and linked Instagram username with followers. Use it as a Facebook Page ID lookup, brand verification checker, or lead‑enrichment step that feeds the Instagram, WhatsApp, and Meta Ad Library scrapers downstream.

✨ Features

• Resolve brand names to Facebook Page IDs via Meta Ad Library's public typeahead endpoint.
• Extract page metadata: display name, category, avatar URL, likes count, and verification status.
• Detect BLUE_VERIFIED badges to confirm official brand pages vs impostors.
• Enrich with linked Instagram handles, follower counts, and IG verification status.
• Capture the page alias (username/slug) used in public Facebook URLs.
• Export one Dataset row per suggestion plus SUMMARY + RESULTS key‑value store objects.
• Retry automatically on transient 429 and 5xx errors for reliable pipelines.
• Integrate as a pre‑step to Meta Ad Library, Instagram, and WhatsApp scrapers.
• Automate with the Apify REST API, webhooks, scheduler, and SDKs.
• Skip Meta's developer approval — no Graph API token, no app review.

🎯 Use Cases

• Resolve Facebook Page IDs: Turn a brand string into a verified numeric Page ID to pass into the Meta Ad Library, Instagram, or WhatsApp ad scrapers.
• Brand Verification & Impostor Detection: Distinguish the official BLUE_VERIFIED page from lookalike or affiliate accounts sharing the same name.
• Sales Lead Enrichment: Batch‑resolve hundreds of brand names from a CRM export into Page IDs, Instagram handles, and follower counts for outbound prioritization.
• Social Footprint Snapshots: Capture a point‑in‑time view of a brand's Facebook + Instagram presence (followers, verification, category) for pitch decks.
• Influencer & Partnership Research: Discover the verified social handles of any brand before proposing partnerships or UGC campaigns.
• Competitive Intelligence Priming: Batch many competitor names into Page IDs, then feed them into the Facebook/Instagram/WhatsApp Ad Library scrapers for ad monitoring.

⚙️ Input Parameters

Name	Type	Required	Description	Example
brand_name	string	Yes	Brand or page name to search in the Meta Ad Library typeahead.	"Nike"

📤 Output Example (JSON)

{
  "adlibrary_url": "15087023549",
  "brand_name": "Nike",
  "category": "Sportswear Store",
  "avatar_url": "https://scontent.../nike-logo.jpg",
  "likes": 38412305,
  "verification": "BLUE_VERIFIED",
  "page_alias": "nike",
  "ig_username": "nike",
  "ig_followers": 302045112,
  "ig_verification": true,
  "search_brand_name": "Nike",
  "timestamp": "2026-04-21T14:22:00Z"
}

▶️ How to Use

1. Run on Apify Console: Open the Facebook Ad Library Brand Finder Actor page, click Try for free, enter brand_name, and press Start. Download matches from the Dataset tab.
2. Via API: Call the Actor with the Apify REST API or ApifyClient and chain the output into your Meta / Instagram / WhatsApp ad scrapers.
3. Via CLI: Run with the Apify CLI:

   $apify call scrapeio/facebook-ad-library-suggestions --input='{"brand_name":"Nike"}'
   

🔗 API Example (JavaScript)

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('scrapeio/facebook-ad-library-suggestions').call({
  brand_name: 'Nike',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
const verified = items.find(p => p.verification === 'BLUE_VERIFIED');
console.log(`Official Nike Page ID: ${verified.adlibrary_url}`);

const adRun = await client.actor('scrapeio/meta-facebook-ad-scrapper-using-ad-library-url-premium').call({
  pageId: verified.adlibrary_url,
  maxResults: 100,
});
console.log(`Launched Ad Library scrape: ${adRun.id}`);

📈 Why Use This Facebook Page ID Finder?

• Speed & Automation: Resolve hundreds of brand names to Page IDs in seconds — no manual Ad Library clicking or hand‑matching.
• Verification Accuracy: Exposes BLUE_VERIFIED vs NOT_VERIFIED so you never target an impostor or fan page by mistake.
• Upstream Data Pipeline: Chain this Actor's output directly into the Meta Ad Library, Instagram Ads, and WhatsApp Ads scrapers for end‑to‑end ad research automation.
• Rich Enrichment: Unique combination of Facebook likes, category, avatar, and linked Instagram handle + followers that the Graph API rarely exposes in one call.
• No Developer Setup: No Graph API token, app review, or Facebook developer account — start resolving brands in seconds.
• Reliability: Built‑in retries on 429 and 5xx errors, structured SUMMARY / RESULTS / ERROR key‑value outputs for robust pipelines.

❓ FAQ

Q: Is it legal to use the Meta Ad Library typeahead? The Ad Library and its helper endpoints are public transparency tools. You are responsible for complying with Meta's Terms of Service, responsible‑use guidelines, and local data‑privacy law.

Q: Does this return every brand on Facebook? No — it returns typeahead suggestions for your query, which depend on Meta's live index and the current region/ad‑type parameters in the request.

Q: Can I change the country or ad type? The current build sends country=IN and ad_type=ALL in the GraphQL payload. Other locales require a source edit and redeploy; contact the maintainer for customization.

Q: Is this the official Facebook Graph API? No. It mirrors the browser‑style typeahead endpoint used by the public Ad Library UI — no developer app, token, or app review is required.

Q: How do I feed this into an ad scraper? Take any adlibrary_url (Page ID) from the Dataset and pass it as pageId into the Meta Ad Library, Instagram Ads, or WhatsApp Ads scrapers.

Q: What happens if the page has no Instagram? ig_username, ig_followers, and ig_verification simply stay empty/null for that row.

Q: Does it support rate limits and retries? Yes — HTTP retries on 429 and 5xx are built in, and you can add Apify Proxy for large scheduled batches.

Q: What output formats are supported? Dataset exports to CSV, JSON, Excel, XML, and HTML. SUMMARY and RESULTS key‑value objects hold run metadata and the full suggestion list.

📣 Find Any Brand's Facebook Page ID in Seconds

Run the Facebook Ad Library Brand Finder on Apify now → and resolve brand names to Page IDs, verification status, and Instagram handles in one call.

---

🔗 Related Scrapers by ScrapeIO

Chain this brand finder into any of these ad‑intelligence Apify Actors:

• Facebook Ad Library Scraper — full Meta ads by keyword, Page ID, or URL.
• Instagram Ads Scraper — Instagram‑only ads with creative and copy.
• WhatsApp Ads Scraper — Click‑to‑WhatsApp ad intelligence.
• Google Maps Scraper — local businesses, reviews, and contacts.
• Amazon Multi‑Marketplace Scraper — ASINs, prices, and rankings across 23 regions.
• Google News Scraper — headlines, sources, and publisher links by keyword.
• YouTube Video Downloader — download videos or audio to cloud storage.

---

Built by ScrapeIO on Apify.

FAQ

How do I get a Facebook Page ID for ad scraping? Run scrapeio/facebook-ad-library-suggestions with brand_name, then pass pageId to the ad scrapers. Pin it in Cursor MCP.

Can I run this Actor with Apify AI? Yes. In Apify Console, type a long request in Store search or the dashboard Ask Apify AI widget. Apify AI matches this README, fills the input schema, asks you to confirm, then returns the dataset. This Actor uses limited permissions (not full-account access) and is not a rental Actor, so it is eligible for Apify AI.

Does this work from Cursor, Claude, or ChatGPT? Yes. Connect the Apify MCP server. Agents call search-actors, fetch-actor-details, and call-actor. Ranking uses the same signals as Store search and Actor quality score: a clear README plus documented input and output schemas.

Powered by AdScrape.