Facebook Video Search Scraper

Facebook Video Search Scraper

The Facebook Video Search Scraper is a purpose-built Facebook video scraper that extracts public video search results by keyword and returns structured JSON for analysis. It solves the manual, time-consuming task of collecting Facebook Watch search results by automating queries, pagination, and extraction in a single run. Ideal for marketers, developers, data analysts, and researchers, this Facebook video search tool scales from quick checks to ongoing monitoring, enabling repeatable data collection and workflows at scale. 🚀

What data / output can you get?

Below are the exact fields this Facebook video data extractor saves to the Apify dataset. These are pushed as JSON objects, one per video result.

Data field	Description	Example value
facebookUrl	Facebook Watch search URL used for the query	https://www.facebook.com/watch/search?q=football
videoUrl	Direct link to the video on Facebook	https://www.facebook.com/watch/?v=1234567890
label	Accessibility label associated with the video card	Video by FC Barcelona, 2 minutes
thumbnail_image.uri	Thumbnail image URL (if available)	https://scontent.xx.fbcdn.net/…/thumb.jpg
video_duration_text	Human-readable video duration	2:15
video.id	Internal video ID (if present)	1234567890
video_owner_profile.name	Name of the page/profile that owns the video	FC Barcelona
video_owner_profile.url	Canonical Facebook URL of the owner	https://www.facebook.com/fcbarcelona
video_owner_profile.is_verified	Normalized verification flag for the owner	true
video_broadcast_status	Broadcast status metadata	VOD
save_description	Save-to-watch-later prompt (if present)	Save this video to watch later.
title	Video title or caption extracted from metadata	Highlights: Epic Goal!
relative_time_string	Relative post time text	3 days ago
facebookId	Mirrors the search URL for traceability	https://www.facebook.com/watch/search?q=football
inputUrl	Mirrors the search URL for traceability	https://www.facebook.com/watch/search?q=football
query	The original keyword you searched	football

Notes:

• Results are available from the Apify dataset and can be exported to JSON, CSV, or Excel for downstream analysis.
• Some nested objects (e.g., video_owner_profile) include additional technical fields like __typename, id, __isNode, __isActor for advanced processing.

Key features

• 🔍 Keyword-first Facebook video search Turn simple keywords into Facebook Watch search URLs automatically and scrape Facebook video search results without needing video URLs upfront.

• 📄 Cursor-based pagination for scale The scraper handles pagination via end_cursor to collect more results per keyword until your defined max is reached.

• 🧱 Structured JSON output Clean, predictable fields (e.g., videoUrl, title, video_owner_profile, thumbnail_image) ready for analytics, enrichment, or pipelines.

• 🌐 Smart proxy handling Built-in proxy setup with a fallback that switches to residential proxies to improve reliability when scraping public Facebook results.

• 💾 Batch dataset writes Saves items in batches to the Apify dataset for faster, more reliable runs at scale.

• 🧰 Developer-friendly Works seamlessly with the Apify platform (API, SDK) and can be integrated into Python pipelines or automation stacks for a Facebook video crawler or Facebook video search scraper Python workflow.

• 🔁 Automation-ready Perfect for recurring data collection, monitoring keywords, or plugging into no-code/low-code automation and reporting pipelines.

• 🧱 Production-focused reliability Retries, response normalization, defensive parsing, and error handling help stabilize large runs on public Facebook search endpoints.

How to use Facebook Video Search Scraper - step by step

1. Create or log in to your Apify account.
2. Open the Facebook Video Search Scraper actor on Apify.
3. Add your keywords under “Search Keywords” (startUrls). Enter one keyword per line (e.g., football, cooking, travel).
4. Adjust “Max Videos per Query” (maxVideos) to set how many results to collect for each keyword.
5. (Optional) Review “Proxy & Privacy” (proxyConfiguration). If Facebook blocks requests, the actor will try datacenter then residential proxies.
6. Start the run. The actor will:
   • Build Facebook Watch search URLs for your keywords.
   • Initialize pagination and request batches of video results.
   • Extract and save structured records to the dataset as it goes.
7. Download your results from the run’s Dataset in JSON, CSV, or Excel to analyze, share, or feed into your systems.

Pro Tip: Use the Apify API or Apify SDK to trigger runs programmatically and pipe the dataset into your data warehouse, dashboards, or alerting workflows.

Use cases

Use case	Description
Marketing + content discovery	Monitor keywords to identify timely public videos and trends for campaign planning and content ideation.
Competitive monitoring	Track public video activity around brands or topics to benchmark messaging and frequency over time.
Social listening for research	Collect structured public video search results for qualitative/quantitative analysis in academic or market research.
Data engineering pipelines	Automate a Facebook video search results extractor to populate analytics tables via the Apify API.
Reporting & dashboards	Feed structured video metadata (title, owner, URL, duration) into BI tools for monitoring.
Automation & alerts	Build a Facebook video monitoring tool that checks new results on a schedule and triggers notifications.

Why choose Facebook Video Search Scraper?

The scraper is built for precision, automation, and reliable Facebook keyword video scraping at scale.

• ✅ Accurate, structured fields mapped from Facebook Watch search results
• 🌍 Works on publicly available data without login or cookies
• 📈 Scales via pagination and batch writes for larger keyword lists
• 🧑‍💻 Developer access through the Apify API/SDK; easy to use in Python pipelines
• 🛡️ Ethical-by-design: built for public data collection use cases
• 💰 Cost-effective automation on Apify infrastructure
• 🔌 Integration-friendly: export to CSV/JSON/Excel, connect to ETL/ELT and workflow tools

Compared to unstable browser extensions or copy-paste workflows, this Facebook video search parser offers a resilient, programmatic approach to scrape Facebook video search results consistently.

Is it legal / ethical to use Facebook Video Search Scraper?

Yes — when done responsibly. This actor targets publicly available Facebook Watch search results and does not access private or authenticated content.

Guidelines to follow:

• Only collect public information you’re authorized to process.
• Comply with Facebook’s Terms of Service and your local regulations (e.g., GDPR, CCPA).
• Avoid scraping private profiles or gated content.
• Use the data for legitimate purposes such as research, analytics, or monitoring.
• Consult your legal team for edge cases or jurisdiction-specific requirements.

Input parameters & output format

Example JSON input

{
  "startUrls": ["football", "basketball"],
  "maxVideos": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameters (from input schema):

• startUrls (array, required)
  • Description: One keyword per line. The actor turns them into Facebook search URLs automatically. Examples: cricket, football, basketball, cooking, travel.
  • Default: none
• maxVideos (integer, optional)
  • Description: How many videos to scrape per keyword (1–1000). Higher = more results, longer run.
  • Default: 20
• proxyConfiguration (object, optional)
  • Description: Optional. No proxy by default. If Facebook blocks you, the actor tries datacenter then residential proxies.
  • Default: none

Example JSON output

[
  {
    "facebookUrl": "https://www.facebook.com/watch/search?q=football",
    "videoUrl": "https://www.facebook.com/watch/?v=1234567890",
    "label": "Video by FC Barcelona, 2 minutes",
    "thumbnail_image": {
      "uri": "https://scontent.xx.fbcdn.net/…/thumb.jpg"
    },
    "video_duration_text": "2:15",
    "video": {
      "id": "1234567890"
    },
    "video_owner_profile": {
      "__typename": "Page",
      "id": "111111111111111",
      "__isNode": "Page",
      "__isActor": "Page",
      "name": "FC Barcelona",
      "url": "https://www.facebook.com/fcbarcelona",
      "is_verified": true
    },
    "video_broadcast_status": "VOD",
    "save_description": "Save this video to watch later.",
    "title": "Highlights: Epic Goal!",
    "relative_time_string": "3 days ago",
    "facebookId": "https://www.facebook.com/watch/search?q=football",
    "inputUrl": "https://www.facebook.com/watch/search?q=football",
    "query": "football"
  }
]

Notes:

• Some fields (e.g., thumbnail_image, video.id, save_description) may be null or missing if not present in the source.
• Download results from the Apify dataset in JSON, CSV, or Excel for downstream processing.

FAQ

Do I need to provide Facebook video URLs to use this?

No. Provide plain keywords in startUrls and the Facebook Video Search Scraper will build the Watch search URLs automatically and extract public results.

Does this scraper collect views, reactions, or comments?

It extracts structured metadata exposed in the public search response, including fields such as videoUrl, title, owner profile details, thumbnail, duration text, and relative time. Engagement counters like views or reactions are not included in the current dataset schema.

Can I use this with Python or via API?

Yes. You can trigger runs and retrieve datasets through the Apify API, making it straightforward to integrate with Python scripts or data pipelines for a Facebook video search scraper Python workflow.

How many results can I collect per keyword?

You control this with maxVideos (1–1000 in the input schema). The scraper paginates through results and saves items in batches until the limit is reached or no further pages are available.

Does it require login or cookies?

No. The scraper targets publicly available Facebook Watch search results and does not require login to operate.

How does it handle blocks or rate limits?

The actor includes retry logic and proxy handling. If Facebook blocks requests, it switches proxies (including residential) to improve continuity, helping you scrape Facebook video search results more reliably.

What export formats are supported?

Results are stored in the Apify dataset, which you can export as JSON, CSV, or Excel to suit downstream analytics or automation workflows.

Is this suitable for ongoing monitoring?

Yes. This Facebook video monitoring tool can be scheduled on Apify to run at intervals, helping you track new public videos for given keywords over time.

Closing CTA / Final thoughts

Built for structured, scalable Facebook keyword video scraping, the Facebook Video Search Scraper automates public Watch search data collection into clean JSON. Marketers, developers, analysts, and researchers can quickly extract video URLs, titles, owners, thumbnails, and more — then export to CSV/JSON/Excel or pipe the data into dashboards and pipelines. Developers can run it via the Apify API or integrate into Python workflows for autonomous, repeatable runs. Start extracting smarter Facebook video insights and turn search results into actionable data today.