# Facebook Video Details Scraper (`axesso_data/facebook-video-details-scraper`) Actor

Scrape real-time details for public Facebook video posts by video ID, including play count, view count, reactions, comments, and media URLs. Delivers accurate, consistent video statistics that can be missing on other post endpoints. Fresh data fetched directly from Facebook - no caching layer.

- **URL**: https://apify.com/axesso\_data/facebook-video-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 Video Details Scraper work?

The Facebook Video Details Scraper extracts detailed, real-time statistics for public Facebook video posts. It is designed for efficiency and ease of use, requiring only the video id to deliver precise and comprehensive video data.

Here's how it works:

1. **Input Parameters:** Simply provide the Facebook `videoId` to extract detailed video data efficiently.

2. **Data Extraction:** The scraper retrieves the video post from Facebook and extracts relevant details, including text content, owner information, engagement metrics (reactions, comments), video statistics (view count, play count), and the underlying media representations (thumbnail and video/audio stream URLs).

3. **Real-Time Output:** Unlike preprocessed data, our scraper retrieves up-to-date video details directly from Facebook, ensuring accurate and fresh data every time. There is no caching involved, so every invocation retrieves fresh data. For accurate metrics such as play count, this endpoint should be preferred over the Post Details endpoint, since some videos are internally classified as Reels, leading to missing or incomplete play count data on that endpoint. The Video Details endpoint always returns consistent and reliable video statistics.

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

With the Facebook Video 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 video to fetch details for. Every field listed below is supported:

| Parameter | Required | Type | Description |
|---|---|---|---|
| `videoId` | Yes | number | Id of the Facebook video, e.g. `1072627888014061`. The `videoId` can be obtained from other sources such as the [Facebook Posts Scraper](https://apify.com/axesso_data/facebook-posts-scraper) or [Facebook Post Details Scraper](https://apify.com/axesso_data/facebook-post-details-scraper) output. |

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

#### Example input

```json
{
  "input": [
    {
      "videoId": 1072627888014061
    },
    {
      "videoId": 648114988018783
    }
  ]
}
```

### Output data

```json
[
  {
    "statusCode": 200,
    "statusMessage": "FOUND",
    "responseStatus": "PRODUCT_FOUND_RESPONSE",
    "responseMessage": "Product successfully found!",
    "videoId": "2405262989953318",
    "feedbackId": "ZmVlZGJhY2s6MTM0ODcyNjAzMDU2NzY1OA==",
    "text": "45 seconds to orbit..\n\nThis video compresses one of the most incredible journeys ever achieved by humanity. In less than an hour, a rocket goes from sitting on a launch pad to traveling around Earth a...",
    "liveStatus": "NEVER_LIVE",
    "ownerId": "102648328814953",
    "ownerName": "SpaceEve",
    "reactionCount": 843,
    "reactionCountDisplay": "843",
    "commentCount": 44,
    "videoViewCount": 30962,
    "playCount": 53739,
    "videoPostViewCount": 30962,
    "topReactions": [
      {
        "type": "Like",
        "count": 765
      },
      {
        "type": "Love",
        "count": 40
      }
    ],
    "thumbnailUrl": "https://scontent.fntr6-3.fna.fbcdn.net/v/t39.30808-1/565691185_1162167219223541_1928443534772218198_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx465x465&ctp=s80x80&_nc_cat=105&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yU6ck...",
    "videoRepresentations": [
      {
        "representationId": "877620415392324v",
        "mimeType": "video/mp4",
        "codecs": "av01.0.04M.08.0.111.01.01.01.0",
        "baseUrl": "https://video.fntr6-5.fna.fbcdn.net/o1/v/t2/f2/m367/AQOqEiS07CWvCdypAju_1ZdtKy85FYG2R9v6LsFOe---6cM1CG80XgztY4udqcQhL62295wvx4eLr7UNawUPaCOHrPtS2RSGCrbgB84.mp4?_nc_cat=106&_nc_oc=Adq7wx5BAkB8TAF1g-yz4...",
        "bandwidth": 91328,
        "height": 960,
        "width": 540
      },
      {
        "representationId": "1575483320609775v",
        "mimeType": "video/mp4",
        "codecs": "av01.0.05M.08.0.111.01.01.01.0",
        "baseUrl": "https://video.fntr6-3.fna.fbcdn.net/o1/v/t2/f2/m367/AQPGgoKvq9iwtLAPeCURz48YQ7-NSF2zCt8jreqntTaBJNxR55G0tnrY_7PFfiIKeyvPqh3WxGtSTid-BIAQ2bnG_EIqRQFZ1DPiBU8.mp4?_nc_cat=105&_nc_oc=AdpkPo4iAUFisB-nv2baJ...",
        "bandwidth": 136116,
        "height": 1280,
        "width": 720
      }
    ],
    "inputVideoId": 2405262989953318
  }
]
```

### How much does Facebook Video 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 video 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 Post Details Scraper](https://apify.com/axesso_data/facebook-post-details-scraper) | Scrape real-time details for any public Facebook post by URL, including full text content, publish date, image URLs, and engagement ... |
| [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 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 video 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 video 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 video 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 video posts 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 video posts 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' video 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 video 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": [
    {
      "videoId": 1072627888014061
    },
    {
      "videoId": 2405262989953318
    }
  ]
}
```

# 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": [
        {
            "videoId": 1072627888014061
        },
        {
            "videoId": 2405262989953318
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("axesso_data/facebook-video-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": [
        { "videoId": 1072627888014061 },
        { "videoId": 2405262989953318 },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("axesso_data/facebook-video-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": [
    {
      "videoId": 1072627888014061
    },
    {
      "videoId": 2405262989953318
    }
  ]
}' |
apify call axesso_data/facebook-video-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-video-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/YKM2F5I0dEVhu7r0R/builds/0har8gOPafVqkP5ea/openapi.json