# Facebook Post Details Scraper (`axesso_data/facebook-post-details-scraper`) Actor

Scrape real-time details for any public Facebook post by URL, including full text content, publish date, image URLs, and engagement metrics such as reactions, comments, and shares. Fresh data fetched directly from Facebook on every run - no caching layer in between.

- **URL**: https://apify.com/axesso\_data/facebook-post-details-scraper.md
- **Developed by:** [AxCrawler](https://apify.com/axesso_data) (community)
- **Categories:** Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

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 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

### How does Facebook Post Details Scraper work?

The Facebook Post Details Scraper retrieves detailed, real-time data for a single Facebook post directly from Facebook. It is designed for efficiency and ease of use, requiring only the post URL to deliver precise and comprehensive post data.

Here's how it works:

1. **Input Parameters:** Simply provide the URL of the Facebook post for which details should be retrieved.

2. **Data Extraction:** The scraper fetches the post and extracts relevant details, including the full text content, publish date, image URLs, and engagement metrics such as reactions, comments, and shares.

3. **Real-Time Output:** Unlike preprocessed data, our scraper retrieves up-to-date post details directly from Facebook, ensuring accurate and fresh data on every run. There is no caching involved, so every invocation retrieves fresh data.

4. **Download Options:** Once the post details are extracted, the data can be downloaded in your preferred format, such as JSON, CSV, Excel, XML, or HTML.

With the Facebook Post Details Scraper, you get a user-friendly, reliable tool that delivers fast, accurate, and customizable data extraction to meet your specific needs.

### Input data

Input data must be provided in JSON format and must contain one mandatory array field "input". Each item in the array represents one Facebook post to retrieve details for. Every field listed below is supported:

| Parameter | Required | Type | Description |
|---|---|---|---|
| `url` | Yes | string | URL of the Facebook post for which details should be retrieved, e.g. `https://www.facebook.com/zuck/posts/10102577175875681`. |

The "input" field is an array, allowing you to pass multiple post URLs in one run, enabling the scraping of details for up to millions of posts in a single Actor run.

#### Example input

```json
{
  "input": [
    {
      "url": "https://www.facebook.com/suemakyantung/posts/pfbid02DQKR2nM6ScoD22Ngwbmbq6nLB9XJwvaeXGA1TxXMv7mPDoMa21y7x5jMCnVHaLDel"
    },
    {
      "url": "https://www.facebook.com/zuck/posts/10102577175875681"
    }
  ]
}
```

### Output data

```json
[
  {
    "statusCode": 200,
    "statusMessage": "FOUND",
    "responseStatus": "PRODUCT_FOUND_RESPONSE",
    "responseMessage": "Product successfully found!",
    "text": "Pay attention!! The monster is coming!! 💋\n.\n日本No.1 唇彩系列*KATE怪獸級持色絨霧唇釉新色登場\n煙燻暗濁色系，輕輕一抹就能與妝容自然融合！\n最新推出秋季顏色M06: Fresh Laterite 略深的紅棕色是我最愛的唇膏色調，輕鬆駕馭不同場合妝容！高顯色之餘持色極高，滋潤度都絕對無令人失望。獨家滋潤凍狀薄膜技術，達到長效持色！ 另外仲有兩款好適...",
    "creationDate": "Thursday, November 30, 2023 at 12:15 PM",
    "imageUrlList": [
      "https://scontent-ham3-1.xx.fbcdn.net/v/t39.30808-6/469099515_18476205664058629_3806734177604140218_n.jpg?stp=dst-jpg_tt6&cstp=mx1440x1800&ctp=s1440x1800&_nc_cat=109&ccb=1-7&_nc_sid=127cfc&_nc_ohc=WBy0...",
      "https://scontent-ham3-1.xx.fbcdn.net/v/t39.30808-6/469064349_18476205646058629_4555283610924675152_n.jpg?stp=dst-jpg_tt6&cstp=mx1440x1800&ctp=s1440x1800&_nc_cat=109&ccb=1-7&_nc_sid=127cfc&_nc_ohc=Frsl..."
    ],
    "postUrl": "https://www.facebook.com/suemakyantung/posts/pfbid09ihHdGqnN7z3dwAE3vjuooudWLaBoaXyzRiapc1D9GvRA35sbFcXKrDNyYdjxy4Sl",
    "postId": "767375192069098",
    "feedbackId": "ZmVlZGJhY2s6NzY3Mzc1MTkyMDY5MDk4",
    "pageId": null,
    "reactionCount": 99,
    "shareCount": 6,
    "commentCount": 1,
    "videoViewCount": null,
    "inputUrl": "https://www.facebook.com/suemakyantung/posts/pfbid02DQKR2nM6ScoD22Ngwbmbq6nLB9XJwvaeXGA1TxXMv7mPDoMa21y7x5jMCnVHaLDel"
  }
]
```

### How much does Facebook Post Details Scraper cost?

With our Pay-Per-Result pricing model, the cost is completely transparent and predictable, unlike renting actors where expenses can be hard to forecast. The price per result can be easily obtained at the top of this listing page, giving you full visibility into your costs before you start scraping.

### What to consider when using this Actor?

We have been performing web crawling activities for over a decade. All our expertise is included in this Actor, this means the user of this Actor is not required to deal with any inconveniences of web scraping.

In detail it means we cover the whole lifecycle including

1. **Proxy Rotation:** We use our own Proxy Pool including several million proxies in all countries worldwide avoiding that our Scraper can be blocked.

2. **Geo Targeting:** We determine the correct proxy location for each request to Facebook, minimizing geo-restriction issues and ensuring reliable access to public post content.

3. **Captchas and Blocking Handling:** Captchas and temporary blocks are completely handled by this Actor under the hood ensuring the user to get always the required data.

4. **Stability and Reliability:** Designed to handle large scale requests with error handling and retries for consistent and dependable operation.

### More Facebook Actors by Axesso

Looking for a different slice of Facebook data? Axesso offers a full suite of real-time Facebook Actors - each one dedicated to a specific endpoint:

| Actor | What it does |
|---|---|
| [Facebook Comments Scraper](https://apify.com/axesso_data/facebook-comments-scraper) | Scrape real-time comments from public Facebook posts including text, timestamps, author info, and engagement metrics. |
| [Facebook Page Info Scraper V2](https://apify.com/axesso_data/facebook-page-info-scraper-v2) | Scrape real-time information from any public Facebook page, including name, follower and like counts, category, contact details, ... |
| [Facebook Posts Scraper](https://apify.com/axesso_data/facebook-posts-scraper) | The Facebook Posts Scraper retrieves real-time posts from any public Facebook page, including text content, images, timestamps, and ... |
| [Facebook Posts Scraper V2](https://apify.com/axesso_data/facebook-posts-scraper-v2) | Scrape real-time posts from public Facebook pages by pageId with automatic pagination and date filtering. |
| [Facebook Reels Scraper](https://apify.com/axesso_data/facebook-reels-scraper) | Scrape real-time reels from any public Facebook page, including captions, publish dates, images, video view counts, and engagement ... |
| [Facebook Video Details Scraper](https://apify.com/axesso_data/facebook-video-details-scraper) | Scrape real-time details for public Facebook video posts by video ID, including play count, view count, reactions, comments, and media URLs. |
| [Facebook Video Search Scraper](https://apify.com/axesso_data/facebook-video-search-scraper) | Search Facebook for video posts by keyword, sorting by relevance or most recent. |

All Axesso Actors are built and maintained to the same standards: real-time data without caching, high availability and active maintenance, consistent input patterns, and responsive support when you need help. If you are missing a specific endpoint, reach out - the portfolio is continuously growing.

### Where else you can find Axesso - Data Service solutions?

Axesso APIs and Actors are available through the Axesso own [API Portal](https://axesso.developer.azure-api.net/apis) and on [RapidAPI](https://rapidapi.com/search?term=axesso\&sortBy=ByRelevance). Our track record includes thousands of subscribers and stable service for over 5 years.

### Use cases for our Axesso Actors

1. **Market Research:** Businesses can utilize this Actor to gather social media data, including posts, engagement metrics, and user sentiment. This information helps in understanding market trends, analyzing competitors, and identifying gaps in content strategies.

2. **Brand Monitoring:** Companies can track mentions of their brand or products on social media using this Actor. This allows them to respond to customer feedback in real-time, manage their online reputation, and engage with their audience effectively.

3. **Audience Insights:** Marketers can analyze social media posts to gain insights into audience preferences, behaviors, and trends. This data can inform content strategies, targeting decisions, and product development.

4. **Content Strategy Development:** Brands with active social media presence can use this Actor to monitor trending topics, popular posts, and user-generated content. This helps in crafting relevant and engaging content that resonates with their audience.

5. **Sentiment Analysis:** Companies can analyze user comments and reactions on social media to gauge public sentiment about their brand, products, or industry. By identifying common themes, brands can adapt their messaging and improve customer satisfaction.

6. **Lead Generation:** Businesses can leverage this Actor to identify potential influencers, partners, or customers by scraping social media for contact information and engagement metrics. This data can be used for targeted outreach and business development efforts.

7. **Content Aggregation and Curation:** Content creators, bloggers, and publishers can use this Actor to aggregate social media posts, images, and user feedback to create curated content such as articles, reviews, or social media roundups.

8. **Competitive Analysis:** Social media marketers can use this Actor to analyze competitors' posts, engagement strategies, and audience interactions. This data can inform their own social media strategies and help them stay competitive.

9. **Ad Campaign Optimization:** Advertisers can gather insights from social media data using this Actor to identify trending topics, popular posts, and effective engagement strategies. This information can be used to optimize ad campaigns and improve overall performance.

### Disclaimer

This Actor is not affiliated or partnered with the vendors used in the Actor; only publicly available data is extracted. Users are responsible for ensuring that their use of the Actor and the returned data complies with applicable laws and the requirements of their individual use case.

# Actor input Schema

## `input` (type: `array`):

List of inputs, each entry refers to one request to be executed. Full list of valid parameters can be found in the README tab.

## Actor input object example

```json
{
  "input": [
    {
      "url": "https://www.facebook.com/suemakyantung/posts/pfbid02DQKR2nM6ScoD22Ngwbmbq6nLB9XJwvaeXGA1TxXMv7mPDoMa21y7x5jMCnVHaLDel"
    },
    {
      "url": "https://www.facebook.com/zuck/posts/10102577175875681"
    }
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "input": [
        {
            "url": "https://www.facebook.com/suemakyantung/posts/pfbid02DQKR2nM6ScoD22Ngwbmbq6nLB9XJwvaeXGA1TxXMv7mPDoMa21y7x5jMCnVHaLDel"
        },
        {
            "url": "https://www.facebook.com/zuck/posts/10102577175875681"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("axesso_data/facebook-post-details-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 = { "input": [
        { "url": "https://www.facebook.com/suemakyantung/posts/pfbid02DQKR2nM6ScoD22Ngwbmbq6nLB9XJwvaeXGA1TxXMv7mPDoMa21y7x5jMCnVHaLDel" },
        { "url": "https://www.facebook.com/zuck/posts/10102577175875681" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("axesso_data/facebook-post-details-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "input": [
    {
      "url": "https://www.facebook.com/suemakyantung/posts/pfbid02DQKR2nM6ScoD22Ngwbmbq6nLB9XJwvaeXGA1TxXMv7mPDoMa21y7x5jMCnVHaLDel"
    },
    {
      "url": "https://www.facebook.com/zuck/posts/10102577175875681"
    }
  ]
}' |
apify call axesso_data/facebook-post-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,axesso_data/facebook-post-details-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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