# Lightweight Facebook Pages Scraper (`oussemafr/lightweight-facebook-pages-scraper`) Actor

Scrape detailed Facebook page information efficiently and cost-effectively with our best scraper. Extract valuable data like page names, URLs, contact details, addresses, likes, and followers for competitive analysis, market research, trend monitoring, and social media analysis.

- **URL**: https://apify.com/oussemafr/lightweight-facebook-pages-scraper.md
- **Developed by:** [Oussema FRIKHA](https://apify.com/oussemafr) (community)
- **Categories:** Lead generation, Social media
- **Stats:** 316 total users, 3 monthly users, 100.0% runs succeeded, 12 bookmarks
- **User rating**: 1.00 out of 5 stars

## Pricing

$20.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

**Introduction:**

Facebook Pages Scraper is a robust and efficient tool designed to extract essential data from Facebook pages. By simply entering the page URL and clicking the "Save & Start" button, users can quickly gather the desired information.

***

**What data can I extract from Facebook pages?:**

Using this Facebook API, you can extract a variety of key data points from Facebook pages, including:

| 📍 About Me Text  | 📄 About Me Text Content| 📰 Ad Page ID      |
| :----------------:| :----------------------:| :-----------------:|
| 🔍 Ad Status      | 🏠 Address              | 👤 Bio             |
| ⏰ Business Hours | 💰 Business Price       | 🛋️ Business Services|
| 📂 Category       | 👥 Confirmed Owner Label| 📅 Creation Date    |
| ✉️ Email           | 👥 Followers Count      | 📸 Image           |
| 🔗 Image Alt      | 👍 Likes Count          | 🗺️ Maps Address    |
| 📞 Phone          | ⭐ Rating               | 📊 Rating Count    |
| 🏷️ Title          | 🌐 URL                  | 🌐 Website         |

***

**Input Options:**

- **start\_urls**: URLs to scrape. Use this field when you have multiple URLs to be scraped.

The input for Facebook Pages Scraper should be Facebook Page URLs such as https://www.facebook.com/humansofnewyork/.

Click on the input tab for a full explanation of an input example in JSON.

```
{
  "startUrls": [
    {
      "url": "https://www.facebook.com/copperkettleyqr/"
    },
    {
      "url": "https://www.facebook.com/HiltonGardenInnMontrealAirport/"
    },
    {
      "url": "https://www.facebook.com/humansofnewyork/"
    }
  ]
}
```

***

**Output and dataset sample:**

```
[
  {
    "about_me_text": "About The Copper Kettle Restaurant",
    "about_me_text_content": "A downtown landmark housed in a heritage building designed circa 1920s with floor to ceiling windows capturing beautiful views of Victoria Park. Family owned by the Gardikiotis' for 57 years. Recently renovated with diverse menu choices specializing in Mediterranean eats,  signature pizza. Outdoor patio and underground parking available with reservation. City wide delivery from our central location. We look forward to your visit!",
    "ad_page_id": "851606664870954",
    "ad_status": "This Page is currently running ads.",
    "address": "1953 Scarth Street, Regina, SK, Canada, Saskatchewan",
    "bio": "Longstanding local restaurant. Mediterranean specialties, signature gourmet pizzas (Best of YQR for",
    "business_hours": "Open now",
    "business_price": "££",
    "business_services": "Outdoor seating",
    "category": [
      "Page",
      "Pizza place"
    ],
    "confirmed_owner_label": null,
    "creation_date": "29 October 2014",
    "description": "The Copper Kettle Restaurant, Regina, Saskatchewan. 2,405 likes · 29 talking about this · 1,080 were here. Longstanding local restaurant. Mediterranean specialties, signature gourmet pizzas (Best of...",
    "email": "copperkettle.events@gmail.com",
    "followers_count": 2694,
    "followers_display": "2.6K followers",
    "image": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.30808-1/298528699_436705561807015_4191178501684731329_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=5f2048&_nc_ohc=FGK-AAylHSkQ7kNvgEFdOy_&_nc_ht=scontent-dfw5-1.xx&oh=00_AYAnGICxdzKPHTstQaIekIRSvseoYMXu7WZjyk3qJc-tJA&oe=6646F35C",
    "image_alt": "The Copper Kettle Restaurant | Regina SK",
    "likes_count": 2405,
    "likes_display": "2.4K likes",
    "maps_address": "https://maps.google.com/maps?q=1953+Scarth+Street%2C+Regina%2C+SK%2C+Canada%2C+Saskatchewan&hl=en&h=AT2EG_sdHEhUx7wnwQbe56ha17wKVnslnU25gSA709RL8e66759QQH87WKX1wQOdoBc28XleUGokLEF375XLmOe04zerCZORZ3NyzIw_Ypfs1X2EuHuv65N6tcwdnGL22uFTQCXLEPqIoR7ZmQj5i7NFWA&s=1",
    "phone": "+1 306-525-3545",
    "rating": "4.5 (203 reviews)",
    "rating_count": "4.5",
    "rating_overall": "203",
    "title": "The Copper Kettle Restaurant | Regina SK",
    "url": "https://www.facebook.com/copperkettleyqr",
    "user_id": "100064027242849",
    "website": "thecopperkettle.online"
  },
  ...
]
```

***

**Your feedback:**

We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for Facebook Pages Scraper or simply found a bug, please create an issue on the Actor’s Issues tab in Apify Console.

***

**Conclusion:**

Facebook Contact Details Scraper is a valuable tool for extracting contact information from facebook pages. Whether for lead generation or data collection, this tool can streamline your workflow and provide valuable insights. Start using it today to boost your marketing and sales efforts!

# Actor input Schema

## `cookies` (type: `array`):

Authenticate the actor with Facebook by installing the Cookie-Editor extension (https://cookie-editor.com/), logging into your facebook.com account, exporting your cookies as JSON with the extension, and pasting the data here.

## `start_urls` (type: `array`):

URLs to start with. Use this field when you have multiple URLs as the starting points.

## `followers_count` (type: `boolean`):

Include exact follower count.

## `about_contact_and_basic_info` (type: `boolean`):

Include the 'Contact and basic info' section.

## `about_details` (type: `boolean`):

Include detailed 'Details About' section.

## `about_profile_transparency` (type: `boolean`):

Include page transparency details.

## `proxyUrls` (type: `object`):

Select proxies to be used by your crawler.

## Actor input object example

```json
{
  "cookies": [],
  "start_urls": [
    {
      "url": "https://www.facebook.com/humansofnewyork"
    },
    {
      "url": "https://www.facebook.com/HiltonGardenInnMontrealAirport/"
    }
  ],
  "followers_count": false,
  "about_contact_and_basic_info": true,
  "about_details": false,
  "about_profile_transparency": false,
  "proxyUrls": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cookies": [],
    "start_urls": [
        {
            "url": "https://www.facebook.com/humansofnewyork"
        },
        {
            "url": "https://www.facebook.com/HiltonGardenInnMontrealAirport/"
        }
    ],
    "proxyUrls": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("oussemafr/lightweight-facebook-pages-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "cookies": [],
    "start_urls": [
        { "url": "https://www.facebook.com/humansofnewyork" },
        { "url": "https://www.facebook.com/HiltonGardenInnMontrealAirport/" },
    ],
    "proxyUrls": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("oussemafr/lightweight-facebook-pages-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 '{
  "cookies": [],
  "start_urls": [
    {
      "url": "https://www.facebook.com/humansofnewyork"
    },
    {
      "url": "https://www.facebook.com/HiltonGardenInnMontrealAirport/"
    }
  ],
  "proxyUrls": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call oussemafr/lightweight-facebook-pages-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=oussemafr/lightweight-facebook-pages-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/IPYzJr9bFeFUufskW/builds/Ekn1rWAjbBgkilPPG/openapi.json