Facebook Video Transcript Scraper

Extracts transcripts, captions, and metadata from public Facebook videos. Useful for developers, researchers, or content creators who need to programmatically obtain video content.

Key Features

• Multi-Video Support: Process multiple video URLs in a single run.
• Affordable: Priced at $5 per run.
• Reliable Execution: Includes 3 retry attempts with exponential backoff and automatic proxy fallback to handle rate limits or blocks.
• Proxy Integration: Uses Apify Proxy by default, with a residential proxy fallback option if requests are blocked.
• Structured Output: Exports clean JSON data, compatible with Apify datasets for real-time streaming.

How to Use

Run the actor via the Apify Console:
1. Go to https://console.apify.com, navigate to the Actors tab.
2. Search for and select facebook-video-transcript-scraper.
3. In the INPUT section, provide your configuration (see Input Format below).
4. Click Start to run the actor. Results will be available in the OUTPUT section upon completion.

Input Format

Configure the actor using a JSON input. The primary method is providing a list of startUrls.

{
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "startUrls": [
    {
      "url": "https://www.facebook.com/username/videos/123456789"
    }
  ]
}

• proxyConfiguration.useApifyProxy: (Boolean) Set to true (recommended) to use Apify Proxy for better reliability.
• startUrls: (Array) A list of objects, each containing a url key with a valid public Facebook video URL.

Output Format

The actor returns an array of JSON objects, one for each processed video.

[
  {
    "url": "https://www.facebook.com/username/videos/123456789",
    "video_id": "123456789",
    "transcript": "Full extracted transcript text appears here...",
    "timestamp": "2024-05-29 12:30:45",
    "success": true,
    "error_message": null,
    "used_proxy_type": "user-selected"
  }
]

• url: The original source video URL.
• video_id: The extracted Facebook video ID.
• transcript: The complete transcript/caption text.
• timestamp: The date and time of extraction (UTC).
• success: Boolean indicating if the extraction was successful.
• error_message: null if successful, otherwise contains error details.
• used_proxy_type: Indicates the proxy used ("user-selected" or "residential-fallback").