Facebook Video Scraper 🧩

Extract detailed metadata from Facebook videos.
This Actor use to extract embedded metadata from public Facebook video pages and returns structured JSON records.

---

Highlights ✅

• Uses for robust metadata extraction (formats, thumbnails, timestamps, uploader info).
• Proxy strategy: No-proxy-first with automatic fallback to Apify Proxy (RESIDENTIAL) — the actor will attempt to fetch pages without a proxy; if that fails (network blocks, rate limits, or inaccessible content), it will automatically retry using Apify Proxy's RESIDENTIAL group when proxyConfiguration/Apify Proxy is available.
• Supports single-URL, array of URLs (urls), or startUrls (requestListSources editor).
• Outputs one dataset item per processed video and also saves a consolidated JSON to the key-value store under key OUTPUT.

---

Example input:

{
  "startUrls": [
          { "url": "https://www.facebook.com/watch?v=1028061379391984" },
          { "url": "https://www.facebook.com/watch?v=1140357574825287" }
  ]
   
}

---

Example Output 📤

keep startUrls prefill items, and retains the proxyConfiguration editor.

[
  {
    "id": "1140357574825287",
    "title": "510K views · 26K reactions | Handsome Hunks | Filmy Fútket",
    "upload_date": "2025-09-18",
    "description": "Handsome Hunks",
    "view_count": "225.6k",
    "concurrent_view_count": "0",
    "uploader": "Filmy Fútket",
    "uploader_id": "61572873492904",
    "platform": "facebook",
    "extractor": "facebook",
    "extractor_key": "Facebook",
    "webpage_url": "https://www.facebook.com/watch?v=1140357574825287",
    "webpage_url_basename": "watch",
    "original_url": "https://www.facebook.com/watch?v=1140357574825287",
    "timestamp": "2025-09-18",
    "timestamp_iso": "2025-09-18T14:08:23Z",
    "duration": "29s",
    "thumbnail": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/548856484_1784241802298314_3498116117151765348_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=105&ccb=1-7&_nc_sid=50ce42&_nc_ohc=20-2gLbj1AEQ7kNvwEytWLq&_nc_oc=AdmuDPd_Lz-Xr1iZvBE5NQv-y0YrJR4W8dU2Ayz3ogee-uXmaZ4lPsbW452GcQiIlxc&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=jVW0FRgZ7m3cvbsBxojn2Q&oh=00_Afj8XoXARa_Ql3VCyiwrDFS5eEq4ymkz7oyXsgUF065RoA&oe=6929A52D",
    "thumbnails": [
      {
        "url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/548856484_1784241802298314_3498116117151765348_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=105&ccb=1-7&_nc_sid=50ce42&_nc_ohc=20-2gLbj1AEQ7kNvwEytWLq&_nc_oc=AdmuDPd_Lz-Xr1iZvBE5NQv-y0YrJR4W8dU2Ayz3ogee-uXmaZ4lPsbW452GcQiIlxc&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=jVW0FRgZ7m3cvbsBxojn2Q&oh=00_Afj8XoXARa_Ql3VCyiwrDFS5eEq4ymkz7oyXsgUF065RoA&oe=6929A52D",
        "id": "0"
      }
    ],
    "ext": "mp4",
    "video_ext": "mp4",
    "http_headers": {
      "User-Agent": "facebookexternalhit/1.1",
      "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
      "Accept-Language": "en-us,en;q=0.5",
      "Sec-Fetch-Mode": "navigate"
    }
  },
  {
    "id": "1028061379391984",
    "title": "795K reactions · 20K shares | এমন একজনকে চাই যে আমাকে ঠিক এভাবেই আগলে রাখবে সারা জীবন 😇😇🥀 #FBTrending #viralchallenge #ViralFacebook #koreanmix #bts #kpop #korea #korean #musicvideo #drama #kdrama #koreanstyle #mix #fangirl #southkorea #leeminho #koreandrama #sulamalis #koreanmodel #sulamalisjakarta #koreandramas #kursussulamalis #sulamaliskorea #sulamalisnatural #heartbrokenlovestory | Arohi Islam",
    "upload_date": "2025-05-12",
    "description": "এমন একজনকে চাই যে আমাকে ঠিক এভাবেই আগলে রাখবে সারা জীবন 😇😇🥀\n#FBTrending #viralchallenge #ViralFacebook \n#koreanmix #bts #kpop #korea #korean #musicvideo #drama #kdrama #koreanstyle #mix #fangirl #southkorea #leeminho #koreandrama #sulamalis #koreanmodel #sulamalisjakarta #koreandramas #kursussulamalis #sulamaliskorea #sulamalisnatural #heartbrokenlovestory",
    "view_count": "10.9M",
    "concurrent_view_count": "0",
    "uploader": "Arohi Islam",
    "uploader_id": "61550107526664",
    "platform": "facebook",
    "extractor": "facebook",
    "extractor_key": "Facebook",
    "webpage_url": "https://www.facebook.com/watch?v=1028061379391984",
    "webpage_url_basename": "watch",
    "original_url": "https://www.facebook.com/watch?v=1028061379391984",
    "timestamp": "2025-05-12",
    "timestamp_iso": "2025-05-12T06:34:13Z",
    "duration": "14m 40s",
    "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/497138445_575803558876566_760069044987240158_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=50ce42&_nc_ohc=XtLkJIYcc94Q7kNvwFO-dpk&_nc_oc=Admdu1P-CSpiPjXzwntDnQvx8xRA4erZ6pbVY7-L0RJgbIYaiTvXSux8ZDXEmIBmhhg&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=Ze478FH1wlCi8I05kd4j6w&oh=00_Afi9ZcEaxIW4wD-DuHnFABHNzZyZVTA94ME4eHM_MnpB5A&oe=6929C569",
    "thumbnails": [
      {
        "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/497138445_575803558876566_760069044987240158_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=50ce42&_nc_ohc=XtLkJIYcc94Q7kNvwFO-dpk&_nc_oc=Admdu1P-CSpiPjXzwntDnQvx8xRA4erZ6pbVY7-L0RJgbIYaiTvXSux8ZDXEmIBmhhg&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=Ze478FH1wlCi8I05kd4j6w&oh=00_Afi9ZcEaxIW4wD-DuHnFABHNzZyZVTA94ME4eHM_MnpB5A&oe=6929C569",
        "id": "0"
      }
    ],
    "ext": "mp4",
    "video_ext": "mp4",
    "http_headers": {
      "User-Agent": "facebookexternalhit/1.1",
      "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
      "Accept-Language": "en-us,en;q=0.5",
      "Sec-Fetch-Mode": "navigate"
    }
  }
]

---

The actor pushes one JSON object per processed URL to the default dataset. It also sets the complete array under the run's key-value store record OUTPUT.

Section	Notable Fields	Description
video	id, desc, date, duration, videoUrl, playAddr, downloadAddr, ratio, cover, statistics	Core video metadata, formatted duration, humanized counts
user	uniqueId, nickname, avatarThumb, verified, secUid	Author identity and profile data, if available
music	id, title, playUrl, coverThumb, authorName	Linked audio metadata
challenges	title, desc, cover	Associated hashtags or challenges
meta	region, language, isAd, duetEnabled, stitchEnabled, labels	Extra flags and content categorization

---

Troubleshooting 🛠

Issue	Likely cause	Suggested fix
Empty dataset	URL not public or blocked by Facebook	Ensure URL is public; enable RESIDENTIAL proxy
Partial metadata	Some fields absent on the page	That’s expected — fields appear only if present in the page JSON
Failures / timeouts	Network blocks, proxy misconfigured	Use Apify Proxy (RESIDENTIAL), increase timeout, enable sticky sessions
Actor input not found	Wrong input shape (e.g. missing startUrls)	Use startUrls, url, or urls as shown in examples

---