Meta Ad Library Brand & Page Explorer

Apify actor: [Add your published Store URL — actor name: facebook-ad-library-suggestions]

Type a brand name and get matching Facebook / Meta pages from the Ad Library typeahead — with verification, likes, category, avatar, and linked Instagram username and follower counts when Meta returns them. One row per suggestion in the Dataset, plus Key-value SUMMARY and RESULTS.

At a glance

Input: brand_name (string, required in schema). The actor POSTs to Meta’s GraphQL typeahead endpoint used by the Ad Library UI (with retries and proxy as configured in code), parses page_results, and pushes one Dataset record per page. Key-value keys: SUMMARY (counts, timestamp), RESULTS (suggestions array + metadata), or ERROR on failure. Current behavior: requests use country IN and ad type ALL in the payload (see main.py) — results are scoped accordingly. Not affiliated with Meta.

Best for: resolving “which Page ID is the official brand?” before running Ad Library scrapers, lead enrichment, and social footprint snapshots.

---

Highlights

Why use it	What you get
Fast resolution	Turn a brand string into page IDs and aliases usable in other actors.
Rich fields	Likes, BLUE_VERIFIED / not verified, IG handle and followers when present.
Triple storage	Dataset (per row) + RESULTS (full list) + SUMMARY.

---

Features

Area	Detail
Input	Single brand_name
Output — Dataset	One item per suggestion: adlibrary_url (page id), brand_name, category, avatar_url, likes, verification, page_alias, ig_username, ig_followers, ig_verification, plus search_brand_name, timestamp
Output — KV	SUMMARY, RESULTS, or ERROR
Reliability	HTTP retries on 429 / 5xx (see implementation)

---

Input

Field	Type	Required	Description
brand_name	string	Yes	Name to search (e.g. Nike, Apple).

{
  "brand_name": "Nike"
}

---

Output

Dataset (one row per match)

Field	Meaning
adlibrary_url	Page ID string (use with Ad Library page searches)
brand_name	Page display name
category	Page category label
avatar_url	Profile image URL
likes	Page like count (if returned)
verification	e.g. BLUE_VERIFIED or NOT_VERIFIED
page_alias	Username / slug
ig_username	Linked Instagram handle
ig_followers	Instagram followers (if returned)
ig_verification	Boolean when present
search_brand_name	Your input
timestamp	ISO time of scrape

Key-value store

Key	Contents
SUMMARY	brand_name, total_results, suggestions_count, timestamp
RESULTS	{ "suggestions": [ ... ], "metadata": { ... } }
ERROR	Present on failure with error, optional raw_response

---

Quick start

1. Set brand_name in Input.
2. Start the actor.
3. Open Dataset for a flat table, or RESULTS in Storage for the full JSON array.

---

FAQ

Is this every brand in the world?
No — it returns typeahead suggestions for your string, subject to Meta’s index and country/ad-type parameters in the request.

Why India (IN)?
The bundled GraphQL variables currently set country": "IN" — change in source if you need another region (requires developer edit and redeploy).

Official API?
No — it mirrors browser-style Ad Library helper calls. Use responsibly.

---

Discoverability & related topics

Facebook Ad Library suggestions Apify · Meta page finder by brand name · Ad Library typeahead scraper · resolve Facebook page ID · Instagram linked to page · brand verification lookup Apify.

---

FastAd — automation & growth tooling.