| ๐ Page name and URL | ๐ Page categories |
| ๐ Website | ๐ง Email address |
| ๐ Address | ๐ฑ Phone number |
| ๐ฅ Followers | ๐ Likes |
| ๐ Social media links | โญ Rating and rating count |
| ๐ Facebook ID and page description | ๐ฃ Messenger link |
| ๐ Creation date | ๐ข Ad status |
### โฌ๏ธย Output example
The scraped Facebook Search data will be shown as a dataset which you can find in the **Output** tab. Note that the output is organized as a table for viewing convenience:
[](https://console.apify.com/actors/Us34x9p7VgjCz99H6/console/)
And here is the same data but in JSON. You can choose in which format to download your Facebook search data: JSON, JSONL, Excel, HTML table or CSV.
```json
[
{
"facebookUrl": "https://www.facebook.com/Jordanmcinnisdesigns/",
"categories": ["Page", "Graphic Designer"],
"info": [
"Jordan Mcinnis Designs, Montreal, Quebec. 88 likes. I'm Jordan Mcinnis, Montreal based Graphic & Web Designer. I Design Websites, Logo, Apps and Many..."
],
"likes": 88,
"messenger": null,
"title": "Jordan Mcinnis Designs | Montreal QC",
"address": "4972 belleville, Montreal, QC, Canada, Quebec https://maps.google.com/maps?q=4972+belleville%2C+Montreal%2C+QC%2C+Canada%2C+Quebec&hl=en",
"pageId": "100068579062225",
"pageName": "Jordanmcinnisdesigns",
"pageUrl": "https://www.facebook.com/Jordanmcinnisdesigns/",
"phone": "+1 514-716-0922",
"email": "mcinnisj.design@gmail.com",
"website": "jordanmcinnis.com",
"rating": "5.0 (6 Reviews)",
"ratingOverall": 5,
"ratingCount": 6,
"followers": 86,
"creation_date": "October 2, 2017",
"ad_status": "This Page is not currently running ads.",
"facebookId": "100068579062225",
"pageAdLibrary": {
"is_business_page_active": false,
"id": "1449158455201923"
}
},
{
"facebookUrl": "https://www.facebook.com/MKDCLangley/",
"categories": ["Page", "Kitchen & bathroom contractor"],
"info": [
"Merit Kitchens Design Centre Langley, Langley, British Columbia. 324 likes",
"1 talking about this",
"10 were here. Along with being an exclusive dealer of..."
],
"likes": 324,
"messenger": null,
"priceRange": "ยฃยฃ",
"title": "Merit Kitchens Design Centre Langley | Langley BC",
"address": "Unit 150 - 19888 Langley Bypass, Langley, BC, Canada, British Columbia https://maps.google.com/maps?q=Unit+150+-+19888+Langley+Bypass%2C+Langley%2C+BC%2C+Canada%2C+British+Columbia&hl=en",
"pageId": "100063562495135",
"pageName": "MKDCLangley",
"pageUrl": "https://www.facebook.com/MKDCLangley/",
"phone": "+1 604-532-7197",
"email": "langley@merit-kitchens.com",
"website": "meritdesignlangley.com",
"rating": "4.2 (8 reviews)",
"ratingOverall": 4.2,
"ratingCount": 8,
"followers": 355,
"creation_date": "May 15, 2012",
"ad_status": "This Page is not currently running ads.",
"about_me": {
"text": "Merit Kitchens was founded by craftspeople in Vancouver, British Columbia, Canada in 1971. Since opening, they began providing Western Canada with high-quality standard and customized kitchen cabinets. The company has long since grown into a world-class supplier of beautiful custom made to order cabinetry with many price points to accommodate most budgets. Today, Merit Kitchens products can be found in homes throughout Canada, the United States, and parts of Asia.\n\nAt Merit Kitchens, we are committed to researching the latest cabinetry trends and techniques and continually blending them with strong, traditional expert construction.\n\nAll our products are manufactured and assembled in our state-of-the-art facility, in British Columbia, where we pair the precision of modern machinery technology with the delicate touch of hand-finishing. \n\nMerit Kitchens Design Centre in Langley offers the complete line of Merit Kitchens cabinets and Lectus cabinets. We also work with top suppliers in counter tops, appliances, and other design elements to help you save time and money. With the help from one of expert designers and professional installers, we will help turn your dream kitchen or bathroom into your reality.",
"urls": []
},
"facebookId": "100063562495135",
"pageAdLibrary": {
"is_business_page_active": false,
"id": "236732366428351"
}
},
{
"facebookUrl": "https://www.facebook.com/mmdesignswindsor/",
"categories": ["Page", "Screen Printing & Embroidery"],
"info": [
"M & M Designs, Windsor, Ontario. 335 likes. We are your premier source for promotional products and custom printing. We offer screen printing, e"
],
"likes": 335,
"messenger": null,
"title": "M & M Designs | Windsor ON",
"address": "3395 Howard Ave, Windsor, ON, Canada, Ontario https://maps.google.com/maps?q=3395+Howard+Ave%2C+Windsor%2C+ON%2C+Canada%2C+Ontario&hl=en",
"pageId": "100069457230966",
"pageName": "mmdesignswindsor",
"pageUrl": "https://www.facebook.com/mmdesignswindsor/",
"phone": "+1 519-982-5252",
"email": "mmdesigns@outlook.com",
"website": "gifts-promotions.com",
"rating": "Not yet rated (1 Review)",
"ratingOverall": null,
"ratingCount": 1,
"followers": 336,
"creation_date": "January 31, 2010",
"ad_status": "This Page is not currently running ads.",
"facebookId": "100069457230966",
"pageAdLibrary": {
"is_business_page_active": false,
"id": "279552274420"
}
}
]
```
### ๐ฉย Want to try other Facebook scraping tools?
Use the dedicated scrapers below if you want to scrape specific public data from Facebook. Each of them is built particularly for the relevant scraping case be it Facebook comments, posts from Facebook groups, Facebook events, images or page reviews. Feel free to browse them:
Apify API reference docs for full details or click on the API tab for code examples and API Endpoints.
#### Can I create a Facebook search integration using data from this scraper?
Yes. Facebook Search Scraper can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. You can integrate with Zapier, Slack, Make, Airbyte, GitHub, Google Sheets, Google Drive, LangChain and more.
Or you can use webhooks to carry out an action whenever an event occurs, e.g. get a notification whenever Facebook Search Scraper successfully finishes a run.
#### Can I use this Facebook Search API in Python?
Yes, by using Apify API. To access the [Facebook Search API using Python](https://apify.com/apify/facebook-search-scraper/api/client/python), use the `apify-client` PyPI package. You can find more details about the client [in our Docs](https://docs.apify.com/api/client/python/).
#### Is it legal to scrape data from Facebook search?
It is legal to scrape publicly available data from Facebook search. However, you should always review and comply with Facebook's terms of service and any applicable laws and regulations regarding web scraping. Additionally, be mindful of any rate limits or restrictions imposed by Facebook to avoid potential issues. You can read more about the legality of web scraping from [our blogpost](https://blog.apify.com/is-web-scraping-legal/).
#### Your feedback
Weโre always working on improving the performance of our Actors. So if youโve got any technical feedback for Facebook Search Scraper or simply found a bug, please create an issue on the Actorโsย [Issues tab](https://apify.com/apify/facebook-search-scraper/issues/open)ย in Apify Console.
# Changelog
This Actor's version history is a separate document: https://apify.com/apify/facebook-search-scraper/changelog.md
# Actor input Schema
## `categories` (type: `array`):
Add one or multiple keywords. You can add the keywords one by one, or use the Bulk edit section to pull them from a prepared list.
## `locations` (type: `array`):
Free text location definition. Just add a name of a country, city or province.
## `searchType` (type: `string`):
Choose the type of Facebook search data you want to scrape. Posts return both images and reels.
## `resultsLimit` (type: `integer`):
Set the number of results you expect for the entire run (if this limit is not set, as many results as possible are returned).
## Actor input object example
```json
{
"categories": [
"Restaurant"
],
"locations": [],
"searchType": "pages",
"resultsLimit": 20
}
```
# Actor output Schema
## `dataset` (type: `string`):
Dataset containing all scraped data
# 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 '