API referenceFacebook
Facebook details
One Facebook post, reel or video, in the standard content shape.
Reads a single Facebook post from its URL and returns it in the standardised shape, so the same parsing code handles it as handles a TikTok or Instagram post.
Works for feed posts, reels and video. Optional flags attach the first page of comments and, for video, a transcript.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/facebook-details" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.facebook.com/reel/1263350412000186" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "attachments": [ { "accessibility_caption": null, "attachment_id": "1263350412000186", "attachment_type": "Video", "image_uri": "https://scontent-atl3-1.xx.fbcdn.net/v/t51.71878-10/658349444_1676184663796494_7909885510096735306_n.jpg?stp=dst-jpg_s526x296_tt6&_nc_cat=106&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=4W58vcgWlFYQ7kNvwF2OOUH&_nc_oc=AdqL6sqcRCKFdQCe72XVnC0fBTvsMOnB_VfjKQQlzb42Txf7RlHA76N93oXs4rL5p_w&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=GOpC… (+96 chars)", "media_url": "https://www.facebook.com/reel/1263350412000186/", "style_list": [ "video_autoplay", "video_inline", "… 3 more items in the full response" ], "video_url": "https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQOl1MWx5X8VIQOHDwTovG82u8oY6m14XXaJChwSLphU4c9jaKE2h0iPR76cX_zzjczzf9sUrDO3lPnzJLAzzfdGToPb-t0gi1zJuWM.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=nQ7SRwevsNgQ7kNvwH1XVek&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI3Ni5… (+758 chars)", "video_url_low_quality": "https://video-atl3-3.xx.fbcdn.net/o1/v/t2/f2/m86/AQO8RYmrUxQ8X_fQ8rpqVT7FUfvdzUrycKIAuQvvUomLA0hHpPNa99qgk4PGeaH2gh6Slf8hALtfHMe1KENpotd4cx0_CtDSURZNUEg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=video-atl3-3.xx.fbcdn.net&_nc_ohc=Nbq6ZiuKu_sQ7kNvwGABJTT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjM2LmR… (+748 chars)", "video_url_source": "browser_native", "video_urls_by_quality": { "high": "https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQOl1MWx5X8VIQOHDwTovG82u8oY6m14XXaJChwSLphU4c9jaKE2h0iPR76cX_zzjczzf9sUrDO3lPnzJLAzzfdGToPb-t0gi1zJuWM.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=nQ7SRwevsNgQ7kNvwH1XVek&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI3Ni5… (+758 chars)", "low": "https://video-atl3-3.xx.fbcdn.net/o1/v/t2/f2/m86/AQO8RYmrUxQ8X_fQ8rpqVT7FUfvdzUrycKIAuQvvUomLA0hHpPNa99qgk4PGeaH2gh6Slf8hALtfHMe1KENpotd4cx0_CtDSURZNUEg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=video-atl3-3.xx.fbcdn.net&_nc_ohc=Nbq6ZiuKu_sQ7kNvwGABJTT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjM2LmR… (+748 chars)", "medium": null, "watermarked": null } } ], "is_sponsored": null, "legacy_story_hideable_id": null, "message_text": "🇺🇸 1 & 2 MAY // DALLAS\n🇺🇸 9 MAY // GEORGE\n🇨🇱 15 MAY // SANTIAGO\n🇦🇷 16 MAY // BUENOS AIRES \n🇺🇸 22 & 23 MAY // MINNEAPOLIS\n🇨🇦 29 & 30 & 31 MAY // TORONTO \n🇺🇸 5 & 6 JUN // WASHINGTON\n🗽 11 & 12 & 13 JUN // NEW YORK\n🇺🇸 18 & 19 JUN // BOSTON\n🇺🇸 25 & 26 & 27 JUN // CHICAGO\n🇲🇽 16 & 17 OCT // MEXICO CITY\n🇬🇹 13 NOV // GUATEMALA … (+86 chars)", "story_type": null }, "main": { "caption": "🇺🇸 1 & 2 MAY // DALLAS\n🇺🇸 9 MAY // GEORGE\n🇨🇱 15 MAY // SANTIAGO\n🇦🇷 16 MAY // BUENOS AIRES \n🇺🇸 22 & 23 MAY // MINNEAPOLIS\n🇨🇦 29 & 30 & 31 MAY // TORONTO \n🇺🇸 5 & 6 JUN // WASHINGTON\n🗽 11 & 12 & 13 JUN // NEW YORK\n🇺🇸 18 & 19 JUN // BOSTON\n🇺🇸 25 & 26 & 27 JUN // CHICAGO\n🇲🇽 16 & 17 OCT // MEXICO CITY\n🇬🇹 13 NOV // GUATEMALA … (+86 chars)", "comment_count": 235, "creator_handle": "Martin Garrix", "hashtags": [], "like_count": 8387, "post_id": "1263350412000186", "post_url": "https://www.facebook.com/reel/1263350412000186", "profile_picture_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/485909256_1218259256325736_3254876605054938336_n.jpg?stp=c83.54.1071.1072a_cp0_dst-jpg_s40x40_tt6&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=XuMxe1Vg_8sQ7kNvwF5KSO8&_nc_oc=AdqWgfG0UAtcXCp4zxbnk4daqrCPOo3lwXZRS_bJ5o7efuztAOhlyM1BX43XkQ7AEAA&_nc_zt=24&_nc_ht=scontent-atl3-… (+113 chars)", "save_count": null, "share_count": 319, "thumbnail_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t51.71878-10/658349444_1676184663796494_7909885510096735306_n.jpg?stp=dst-jpg_s526x296_tt6&_nc_cat=106&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=4W58vcgWlFYQ7kNvwF2OOUH&_nc_oc=AdqL6sqcRCKFdQCe72XVnC0fBTvsMOnB_VfjKQQlzb42Txf7RlHA76N93oXs4rL5p_w&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=GOpC… (+96 chars)", "upload_timestamp": 1775381330, "video_url": "https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQOl1MWx5X8VIQOHDwTovG82u8oY6m14XXaJChwSLphU4c9jaKE2h0iPR76cX_zzjczzf9sUrDO3lPnzJLAzzfdGToPb-t0gi1zJuWM.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=nQ7SRwevsNgQ7kNvwH1XVek&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI3Ni5… (+758 chars)", "video_url_low_quality": "https://video-atl3-3.xx.fbcdn.net/o1/v/t2/f2/m86/AQO8RYmrUxQ8X_fQ8rpqVT7FUfvdzUrycKIAuQvvUomLA0hHpPNa99qgk4PGeaH2gh6Slf8hALtfHMe1KENpotd4cx0_CtDSURZNUEg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=video-atl3-3.xx.fbcdn.net&_nc_ohc=Nbq6ZiuKu_sQ7kNvwGABJTT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjM2LmR… (+748 chars)", "video_url_source": "browser_native", "video_urls_by_quality": { "high": "https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQOl1MWx5X8VIQOHDwTovG82u8oY6m14XXaJChwSLphU4c9jaKE2h0iPR76cX_zzjczzf9sUrDO3lPnzJLAzzfdGToPb-t0gi1zJuWM.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=nQ7SRwevsNgQ7kNvwH1XVek&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI3Ni5… (+758 chars)", "low": "https://video-atl3-3.xx.fbcdn.net/o1/v/t2/f2/m86/AQO8RYmrUxQ8X_fQ8rpqVT7FUfvdzUrycKIAuQvvUomLA0hHpPNa99qgk4PGeaH2gh6Slf8hALtfHMe1KENpotd4cx0_CtDSURZNUEg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=video-atl3-3.xx.fbcdn.net&_nc_ohc=Nbq6ZiuKu_sQ7kNvwGABJTT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjM2LmR… (+748 chars)", "medium": null, "watermarked": null }, "view_count": 383000 } } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "facebook-details", "billable": true, "duration_ms": 3943 }}