Skip to main content

Facebook Reels & Video Scraper — Python SDK

Python client for the Facebook Reels & Video Scraper Apify Actor. Send public Actor inputs, wait for the hosted run, and receive clean Dataset rows without maintaining scraping infrastructure.

Apify Actor Python 3.9+ License: MIT

Results

  • Direct URL, search and profile workflows
  • MP4 links and public engagement metrics
  • Captions and available transcripts
  • Date and caption keyword filters

Result availability follows the public page and video visibility. Collection remains inside the hosted Actor.

Install

pip install git+https://github.com/apivault-labs/facebook-reels-video-scraper-python.git

Create an Apify token at Console → Integrations, then:

from facebook_reels_video_scraper import FacebookReelsVideoScraperClient

client = FacebookReelsVideoScraperClient(api_token="apify_api_xxxxxx")
rows = client.run({'profileUrls': ['https://www.facebook.com/facebook'],
 'maxReelsPerProfile': 200,
 'downloadMp4': True})
print(rows[0] if rows else "No results")

You can set APIFY_API_TOKEN instead of passing the token in code.

Public input options

Field Type Default Description
workflow string auto Automatically select a URL, search or profile workflow.
startUrls array [] Public Reel or video URLs.
searchQueries array [] Keywords or hashtags to search.
profileUrls array [] Public profile or Page URLs.
maxReelsPerProfile integer 200 Maximum videos per supplied profile.
maxResults integer 200 Maximum total results.
maxCostUsd number 0 Optional Actor charge cap.
sinceDays integer 0 Keep videos from the last N days.
keywordFilter string `` Keep captions containing this text.
enrichDetailPage boolean True Request the complete public result when available.
downloadMp4 boolean True Include an available MP4 URL.
includeTranscript boolean True Include available native captions or transcript.
dedupe boolean True Return each video once.
outputPreset string full Choose a public result layout.

The complete, versioned schema is also available on the Actor page.

Pricing

Pay per delivered result through Apify, starting around $3/1,000 results on paid tiers. Free-plan pricing and platform usage can differ; check the Actor page before large runs.

Examples

  • examples/quickstart.py — first run
  • examples/bulk_analysis.py — expand a target list
  • examples/export_csv.py — save flat result fields
  • examples/save_json.py — preserve nested output
  • examples/cost_estimate.py — estimate result-event charges
  • examples/environment_token.py — keep credentials out of code

Architecture and privacy

This repository is intentionally a thin API client. Collection, retries, analysis and billing run inside the hosted Apify Actor. No private implementation, credentials, scoring weights or infrastructure configuration are included.

License

MIT. The hosted Actor is a separate paid service governed by Apify terms.

Release files for facebook-reels-video-scraper 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for facebook-reels-video-scraper 0.1.0
File Size Uploaded
facebook_reels_video_scraper-0.1.0.tar.gz 5.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for facebook-reels-video-scraper 0.1.0
File Interpreter ABI Platform
facebook_reels_video_scraper-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.6 kB

Release files / facebook_reels_video_scraper-0.1.0.tar.gz

Download URL facebook_reels_video_scraper-0.1.0.tar.gz
Size 5.2 kB
Tags Source
SHA-256 checksum
How to use checksums
974ba4658d719aa9eae87981d36d5af2d31b27aaf50c7c54647bdd30873009b7
BLAKE2b-256 checksum
How to use checksums
0aa699b7b331da6ff83476acfe74af6adf1e796b8d7e353421e8cce96d192782
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / facebook_reels_video_scraper-0.1.0-py3-none-any.whl

Download URL facebook_reels_video_scraper-0.1.0-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
01b9e26848a546817d62ea6ad3c2c31cf3c796acad2c919eea09566d5d8a6ca5
BLAKE2b-256 checksum
How to use checksums
b6c0162edec7ab6ec1e77fdb0b60b0d4b23666ef4fc4bc28bf7abf8d53ab0fff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page