# Facebook Search Scraper (`parseforge/facebook-search-scraper`) Actor Discover Facebook pages that match any keyword! Collect page names, URLs, descriptions, categories, likes, followers, verification status, addresses, phones, and websites at scale. Ideal for competitor research, influencer discovery, and local business intelligence. Start searching Facebook today! - **URL**: https://apify.com/parseforge/facebook-search-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Social media, Lead generation, Marketing - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ‘ฅ Facebook Search Scraper > ๐Ÿš€ **Find Facebook pages for any keyword in seconds.** Get **18 fields per page** including likes, followers, category, description, address, phone, website, profile picture, and verified status. No login, no API key, no Meta Developer account. > ๐Ÿ•’ **Last updated:** 2026-04-24 ยท **๐Ÿ“Š 18 fields** per page ยท **๐Ÿ”Ž Keyword search + enrichment** ยท **โšก 100 pages in ~60 seconds** ยท **๐ŸŒ Residential proxy ready** The **Facebook Search Scraper** discovers Facebook pages matching any search keyword and enriches each hit with public metadata pulled directly from the page. Search goes through an external index, then the scraper visits each matching Facebook URL to extract likes, followers, profile picture, cover photo, category, description, and contact details (address, phone, website) when available in JSON-LD markup. Concurrent enrichment keeps throughput high and the output consistent. Feed a brand name and get the top pages; feed a product category and discover every public Facebook brand operating in it. Works on pages, public groups, and public events. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Marketers, brand managers, competitive analysts, lead-gen teams, local-business researchers, journalists | Brand discovery, competitor auditing, local lead generation, PR research, CRM enrichment | --- ### ๐Ÿ“‹ What the Facebook Search Scraper does Six discovery workflows in a single run: - ๐Ÿ”Ž **Keyword search.** External search finds Facebook pages matching any query. - ๐Ÿ‘ **Engagement metrics.** Likes count and followers count extracted from each page. - ๐Ÿข **Business data.** Category, description, and verified status parsed from Open Graph and JSON-LD. - ๐Ÿ“ž **Contact info.** Address, phone, website pulled from JSON-LD when present. - โญ **Rating.** Star rating and review count for pages that expose them publicly. - ๐Ÿ–ผ๏ธ **Media.** Profile picture and cover photo URLs for downstream embedding. Each record includes the originating query, page URL, slug, rank position, and timestamp. > ๐Ÿ’ก **Why it matters:** finding Facebook pages at scale means bouncing between search engines and page-by-page audits. This Actor consolidates that into a single dataset with structured fields. --- ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon: a 3-minute walkthrough of competitor page discovery and enrichment._ --- ### โš™๏ธ Input
InputTypeDefaultBehavior
queriesarray of stringsrequiredOne or more search keywords.
searchTypestring"pages"pages, groups, or events.
resultsPerQueryinteger10Pages returned per query.
enrichPagesbooleantrueVisit each page to fetch full metadata.
maxItemsinteger10Records returned. Free plan caps at 10, paid plan at 1,000,000.
proxyConfigurationobjectRESIDENTIALResidential proxy strongly recommended.
**Example: brand discovery across top brands.** ```json { "queries": ["nike", "adidas", "puma"], "searchType": "pages", "resultsPerQuery": 10, "enrichPages": true, "maxItems": 30 } ```` **Example: local-business discovery in a specific category.** ```json { "queries": ["yoga studio seattle", "coffee shop portland"], "searchType": "pages", "resultsPerQuery": 20, "enrichPages": true, "maxItems": 40 } ``` > โš ๏ธ **Good to Know:** Facebook blocks datacenter IPs for page reads. Always use Apify residential proxy on paid plans. Private groups and events are not discoverable, only public pages and public groups. *** ### ๐Ÿ“Š Output Each record contains **18 fields**. Download the dataset as CSV, Excel, JSON, or XML. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ”Ž `query` | string | `"nike"` | | ๐ŸŽฏ `type` | string | `"pages"` | | ๐Ÿ† `rank` | number | `1` | | ๐Ÿท๏ธ `name` | string | null | `"Nike"` | | ๐Ÿ”— `url` | string | `"https://www.facebook.com/nike"` | | ๐Ÿ†” `slug` | string | null | `"nike"` | | ๐Ÿ“ `description` | string | null | `"Spotlighting athlete stories."` | | ๐Ÿ†” `pageId` | string | null | `"15087023444"` | | ๐Ÿท๏ธ `category` | string | null | `"Sports & Fitness"` | | ๐Ÿ‘ `likes` | number | null | `39645362` | | ๐Ÿ‘ฅ `followers` | number | null | `39000000` | | โญ `rating` | number | null | `4.5` | | ๐Ÿ“ `reviewCount` | number | null | `1200` | | ๐Ÿ“ `address` | string | null | `"One Bowerman Drive, Beaverton, OR"` | | ๐Ÿ“ž `phone` | string | null | `"+1 503 555 0100"` | | ๐ŸŒ `website` | string | null | `"http://nike.com"` | | โœ… `verified` | boolean | `true` | | ๐Ÿ–ผ๏ธ `profilePicUrl` | string | null | `"https://scontent.../nike.jpg"` | | ๐Ÿ–ผ๏ธ `coverPhotoUrl` | string | null | `"https://scontent.../cover.jpg"` | | ๐Ÿ•’ `scrapedAt` | ISO 8601 | `"2026-04-21T12:00:00.000Z"` | | โ— `error` | string | null | `"Timeout"` on failure | #### ๐Ÿ“ฆ Sample records
๐Ÿ† Major global brand ```json { "query": "nike", "type": "pages", "rank": 1, "name": "Nike", "url": "https://www.facebook.com/nike", "slug": "nike", "description": "Spotlighting athlete stories.", "pageId": "15087023444", "category": "Sports & Fitness", "likes": 39645362, "followers": 39000000, "rating": null, "reviewCount": null, "address": null, "phone": null, "website": "http://nike.com", "verified": true, "profilePicUrl": "https://scontent-sjc3.xx.fbcdn.net/.../nike.jpg", "coverPhotoUrl": null, "scrapedAt": "2026-04-21T12:00:00.000Z" } ```
๐Ÿฌ Local business with contact info ```json { "query": "coffee shop portland", "type": "pages", "rank": 2, "name": "Stumptown Coffee Roasters", "url": "https://www.facebook.com/stumptowncoffee", "slug": "stumptowncoffee", "description": "Direct trade, artisanal, and damn delicious coffee.", "pageId": "103287213029401", "category": "Coffee Shop", "likes": 127500, "followers": 130000, "rating": 4.6, "reviewCount": 342, "address": "128 SW 3rd Ave, Portland, OR 97204", "phone": "+1 503 295 6144", "website": "https://www.stumptowncoffee.com", "verified": false, "profilePicUrl": "https://scontent.../stumptown.jpg", "coverPhotoUrl": "https://scontent.../cover.jpg", "scrapedAt": "2026-04-21T12:00:00.000Z" } ```
๐Ÿšง Page with limited public data ```json { "query": "small-brand-example", "type": "pages", "rank": 1, "name": "Small Brand", "url": "https://www.facebook.com/smallbrandexample", "slug": "smallbrandexample", "description": null, "pageId": null, "category": null, "likes": null, "followers": null, "rating": null, "reviewCount": null, "address": null, "phone": null, "website": null, "verified": false, "profilePicUrl": "https://scontent.../placeholder.jpg", "coverPhotoUrl": null, "scrapedAt": "2026-04-21T12:00:00.000Z" } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐Ÿ”Ž | **Real keyword search.** Discovers pages beyond what you already know. | | ๐Ÿ“Š | **18 fields per page.** Likes, followers, category, address, phone, rating, website, and more. | | โšก | **Fast.** 100 pages in about 60 seconds with parallel enrichment. | | ๐Ÿข | **Local business ready.** Captures address, phone, and website for local SEO research. | | ๐Ÿšซ | **No Meta Developer account.** Public page data without API keys or app review. | | ๐Ÿ” | **Batch-ready.** Feed a list of keywords and get every matching page in one dataset. | | ๐Ÿ”Œ | **Integrations.** Drops into CRMs, Sheets, Slack, and any marketing automation. | > ๐Ÿ“Š Facebook remains the largest business directory on the internet. Accurate page metrics drive competitor analysis and local marketing decisions. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ Facebook Search Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Public pages worldwide | **Live per run** | keyword list, enrichment toggle | โšก 2 min | | Meta Graph API | Free | Only your own pages | Real-time | Owner data | ๐Ÿ•’ Variable | | Paid business listings | $299+/month | Managed directories | Monthly | Rich filters | โณ Hours | | DIY scrapers | Free | Whatever you code | Your schedule | Your work | ๐Ÿข Days | Pick this Actor when you want pay-per-use Facebook page discovery without Graph API limits. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the Facebook Search Scraper page on the Apify Store. 3. ๐ŸŽฏ **Set queries.** Add keywords and pick `resultsPerQuery` and whether to enrich. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor find pages. 5. ๐Ÿ“ฅ **Download.** Grab your dataset as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿ“ฃ Brand & Marketing - Discover official pages for any brand - Track competitor follower growth - Detect unofficial pages and fan communities - Benchmark category metrics #### ๐Ÿ’ผ Lead Generation - Find local businesses in a category - Enrich CRM records with Facebook data - Prioritize leads by verified status - Build outreach lists for sales
#### ๐Ÿ“Š Competitive Intelligence - Map every brand competing in your niche - Track launch pages and campaigns - Capture category leaders by likes - Archive page metadata over time #### ๐Ÿ“ฐ PR & Research - Find brand pages for press outreach - Research local-business angles for features - Map community group presence - Gather contact info for media pitches
*** ### ๐Ÿ”Œ Automating Facebook Search Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - ๐ŸŸข **Node.js.** Install the `apify-client` NPM package. - ๐Ÿ **Python.** Use the `apify-client` PyPI package. - ๐Ÿ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Weekly brand-page refresh keeps CRM enrichment current. ### ๐ŸŒŸ Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### ๐ŸŽจ Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### ๐Ÿค Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### ๐Ÿงช Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
*** ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20FACEBOOK%20SEARCH%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20FACEBOOK%20SEARCH%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20FACEBOOK%20SEARCH%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20FACEBOOK%20SEARCH%20SCRAPER%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? Pass a list of keywords. The Actor queries an external search index for Facebook URLs matching each keyword, then visits each page and extracts likes, followers, category, description, contact info, and media URLs. #### ๐Ÿ“ How accurate is the data? Follower and like counts match what the page displays publicly. Address, phone, and website only populate when the page owner enables that info in their public metadata. #### ๐Ÿ”Ž How many pages will each query return? Typically 10 to 30 unique Facebook URLs per keyword, depending on how densely the external search index has indexed that query. Broad keywords like "nike" return top brands; local queries return 5-20 local businesses. #### ๐Ÿ”’ Can it access private pages or groups? No. Only publicly viewable pages and public groups are discoverable and enrichable. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to refresh keyword-based page discovery weekly or monthly. #### โš–๏ธ Is it legal? Accessing publicly available page metadata is generally fine for research, CRM, and marketing. Commercial redistribution may require permission. Consult legal counsel for your specific use case. #### ๐Ÿ’ผ Can I use this commercially? Yes for internal research, CRM enrichment, and marketing. Reselling the raw data may violate Facebook's terms of service. #### ๐Ÿ’ณ Do I need a paid Apify plan to use this Actor? The free plan covers testing (10 results per run). A paid plan lifts the limit AND gives you residential proxy access, which is strongly recommended for Facebook. #### ๐Ÿ” What happens if a run fails? Apify retries transient errors. Per-query and per-page failures are logged with `error` fields. Partial datasets are preserved. #### ๐Ÿ“ Can I target specific countries? Add country terms to your query (e.g., "sushi restaurant tokyo"). The search index generally localizes based on the keyword. #### ๐Ÿ“ธ Can I get posts or reviews? Use the Facebook Posts Scraper or Facebook Reviews Scraper for media and review content. This Actor focuses on page-level discovery. #### ๐Ÿ†˜ What if I need help? Our team is available through the Apify platform and the Tally form below. *** ### ๐Ÿ”Œ Integrate with any app Facebook Search Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate page discovery workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Sync new pages to your CRM - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Alert on new competitor pages - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe pages into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export page data to Sheets You can also use webhooks to trigger downstream enrichment and alerting workflows. *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿ“ฃ Facebook Pages Scraper**](https://apify.com/parseforge/facebook-pages-scraper) - Full data from a specific page - [**๐Ÿ“ Facebook Posts Scraper**](https://apify.com/parseforge/facebook-posts-scraper) - Posts from any public page - [**โญ Facebook Reviews Scraper**](https://apify.com/parseforge/facebook-reviews-scraper) - Reviews for any public page - [**๐Ÿ“ธ Instagram Search Scraper**](https://apify.com/parseforge/instagram-search-scraper) - Profile lookup on Instagram - [**๐Ÿ“ง Contact Info Scraper**](https://apify.com/parseforge/contact-info-scraper) - Emails and socials from URLs > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more social media tools. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with Meta or Facebook. It accesses only publicly available page data via external search indexes. Respect Facebook's terms of service and applicable privacy laws when using the data. # Actor input Schema ## `queries` (type: `array`): List of search queries ## `searchType` (type: `string`): Type of entity to search ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `proxyConfiguration` (type: `object`): Apify proxy configuration ## Actor input object example ```json { "queries": [ "nike", "apple" ], "searchType": "pages", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Complete dataset # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "nike", "apple" ], "searchType": "pages", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/facebook-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": [ "nike", "apple", ], "searchType": "pages", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("parseforge/facebook-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "nike", "apple" ], "searchType": "pages", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call parseforge/facebook-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/facebook-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Search Scraper", "description": "Discover Facebook pages that match any keyword! Collect page names, URLs, descriptions, categories, likes, followers, verification status, addresses, phones, and websites at scale. Ideal for competitor research, influencer discovery, and local business intelligence. Start searching Facebook today!", "version": "1.0", "x-build-id": "1JhWc2ebXkBdioKTc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~facebook-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-facebook-search-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/parseforge~facebook-search-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-facebook-search-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/parseforge~facebook-search-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-facebook-search-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search Queries", "type": "array", "description": "List of search queries", "items": { "type": "string" } }, "searchType": { "title": "Search Type", "enum": [ "pages", "groups", "posts", "videos" ], "type": "string", "description": "Type of entity to search" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify proxy configuration" } } }, "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 } } } } } } } } } } ```