Facebook Page Search - Pages & Keywords Finder

Search Facebook Pages and keywords using the Ad Library autocomplete API. Find pages by name, discover keyword suggestions, and retrieve detailed page profiles (including Category, Page ID, likes, verification status, and Instagram follower count). Perfect for discovering competitor Page IDs and keyword trends. Built with Apify best practices for reliability and speed.

---

Table of Contents

• Features
• Use Cases
• Quick Start
• Input Parameters
• Output Format
• Supported Countries
• Performance & Limits
• FAQ
• Troubleshooting
• Tags

---

Features

• Page Finder - Locate any advertiser Facebook Page by searching their name or brand keyword.
• Page ID Extraction - Find the precise numerical Page ID needed to run page-specific ad library scrapes.
• Keyword Autocomplete - Discover relevant search query suggestions directly from Facebook's system.
• Profile Metadata - Retrieve page logos (image_uri), likes, category, and alias names.
• Instagram Sync - Extract connected Instagram profiles, follower counts, and verification badges.
• Regional Context - Target autocomplete contexts using 50+ supported countries.
• Single API Call Efficiency - Lightning fast execution since suggestions require no complex pagination loop.

---

Use Cases

Use Case	Description	Key Benefits
Competitor ID Discovery	Find a brand's exact Facebook Page ID to feed into the Page Ads Scraper.	Crucial mapping step for automated competitive tracking.
Keyword Expansion	Discover autocomplete suggestions related to your niche terms.	Identify related search terms and audience interest signals.
Brand Auditing	Identify verified pages, like counts, and linked Instagram profiles.	Measure social presence and verification status of page entities.
Regional Research	Discover page variations and suggestions in different international contexts.	Map out global vs local advertiser strategies.
Data Pre-processing	Automatically resolve brand names into Page IDs before running main scrapes.	Streamline high-volume scraping workflows.

---

Quick Start

1. Basic - Search a Page/Brand Name

{
  "query": "gymshark",
  "country": "US"
}

2. Advanced - Regional Autocomplete Suggestions

{
  "query": "tech tools",
  "country": "DE"
}

---

Input Parameters

Parameter	Type	Required	Description	Default	Example
query	String	Yes	The search keyword, brand name, or phrase to lookup suggestions for	-	"gymshark", "nike", "dropshipping"
country	String	No	Two-letter country code (ISO 3166-1 alpha-2) for context	"US"	"US", "GB", "CA", "DE", "IN"

---

Output Format

The actor outputs suggestion objects in a single flat list, using the result_type attribute (page, keyword, or location) to distinguish between record types.

Output Example (Page Suggestion)

{
  "source": "facebook_page_search",
  "search_query": "gymshark",
  "country": "US",
  "result_type": "page",
  "position": 1,
  "name": "Gymshark",
  "page_id": "102484795092789",
  "category": "Sportswear Store",
  "image_uri": "https://scontent.xx.fbcdn.net/v/t39.35426-6/...",
  "likes": 2400320,
  "verification": "blue_verified",
  "entity_type": "page",
  "ig_username": "gymshark",
  "ig_followers": 6120480,
  "ig_verification": "blue_verified",
  "page_alias": "gymshark",
  "page_is_deleted": false,
  "keyword": null,
  "scraped_at": "2026-06-23T13:20:00.000Z"
}

Output Example (Keyword Suggestion)

{
  "source": "facebook_page_search",
  "search_query": "gymshark",
  "country": "US",
  "result_type": "keyword",
  "position": 5,
  "name": "gymshark clothing",
  "keyword": "gymshark clothing",
  "page_id": null,
  "category": null,
  "image_uri": null,
  "likes": null,
  "verification": null,
  "entity_type": null,
  "ig_username": null,
  "ig_followers": null,
  "ig_verification": null,
  "page_alias": null,
  "page_is_deleted": null,
  "scraped_at": "2026-06-23T13:20:05.000Z"
}

Output Fields Explained

Field	Type	Description
source	String	Source indicator, always facebook_page_search
search_query	String	The query term used for search
country	String	The country code used for regional context
result_type	String	Type of suggest result (page, keyword, or location)
position	Integer	Position of the result in the suggestions list (1-based)
name	String	Target name (either the page name, keyword text, or location string)
page_id	String	Facebook Page ID (for page type, otherwise null)
category	String	Page business category (e.g. "Clothing Brand")
image_uri	String	URL to the page logo/avatar image
likes	Integer	Total Facebook page likes
verification	String	Page verification status (e.g. "blue_verified")
entity_type	String	Type code of entity (usually "page")
ig_username	String	Linked Instagram account handle
ig_followers	Integer	Follower count of linked Instagram account
ig_verification	String	Verification status of linked Instagram account
page_alias	String	Page alias identifier / slug name
page_is_deleted	Boolean	Whether the page is flagged as deleted
keyword	String	Autocomplete suggestion keyword (for keyword type, otherwise null)
scraped_at	String	Timestamp of scraping run

---

Supported Countries

The autocomplete context API uses 50 countries. Here are some of the most commonly used country codes:

Region	Code	Region	Code	Region	Code
United States	US	United Kingdom	GB	Canada	CA
Australia	AU	India	IN	Germany	DE
France	FR	Italy	IT	Spain	ES
Brazil	BR	Mexico	MX	Japan	JP
South Korea	KR	Netherlands	NL	Sweden	SE
Poland	PL	Türkiye	TR	United Arab Emirates	AE
Saudi Arabia	SA	Singapore	SG	Indonesia	ID

(Check .actor/input_schema.json for the complete list of 50 supported countries).

---

Performance & Limits

• Pagination - Autocomplete does not support pagination. It is a single, direct request.
• Speed - Runs extremely fast (normally under 3 seconds) since it only calls one endpoint once.
• Yield - Returns up to ~10-20 suggestions mixed between keywords, pages, and locations depending on search volume.

---

FAQ

• Q: How do I find the Page ID from this?
  • Search for your brand name or competitor page name. The results with result_type = "page" will list the exact page_id in the dataset table.
• Q: Does this scraper require cookies?
  • No login, credential mapping, or cookies are needed.
• Q: Why are some fields null?
  • Suggestions can be simple search keywords (e.g. "nike shoes") which do not have page information like Page ID, category, or Instagram followers. Those fields will remain null.

---

Troubleshooting

Issue	Cause	Solution
"No search query provided"	Empty or missing query	Provide a valid search term in the input
No suggestions returned	The query is extremely unique or obfuscated	Try shorter keywords or common terms
API errors / timeouts	Temporary server lag	The actor automatically retries and handles errors internally

---

Why Choose This Actor?

• Fast brand name to Page ID mapping
• Combines pages, keywords, and location suggestions
• Extracts detailed likes, category, and verification badges
• Includes linked Instagram account profiles & followers
• Single API call (highly credit efficient)
• Downloadable as CSV, Excel, JSON, or HTML

---

Tags

facebook page search, facebook page id finder, autocomplete scraper, facebook brand search, competitor finder, instagram profile finder, ad library autocomplete, spy tool helpers, marketing automation, apify actor

---

Get Started Now

1. Enter the Search Query (e.g., brand name or topic)
2. Select the Country context
3. Click Start to run the scraper
4. Browse/download suggestions and extract competitor Page IDs
5. Feed Page IDs into the Facebook Page Ads Scraper
6. Click "Try for free" to test the actor

---

Related Actors

• Facebook Ads Search Scraper - Search ads across the entire Ad Library by keyword.
• Facebook Page Ads Scraper - Scrape ads from specific Facebook Pages.

Built using Apify Platform | Optimized for Performance & Reliability