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.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 4.5s.
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 }}