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.
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 runexamples/bulk_analysis.py— expand a target listexamples/export_csv.py— save flat result fieldsexamples/save_json.py— preserve nested outputexamples/cost_estimate.py— estimate result-event chargesexamples/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)
| File | Size | Uploaded | |
|---|---|---|---|
| facebook_reels_video_scraper-0.1.0.tar.gz | 5.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|