API referenceFacebook
Facebook post
One Facebook post, with the platform's own richer post record.
The same target as facebook-details, returned with more of what
Facebook itself publishes about a post. Choose this when you want detail
the standardised shape does not carry, and facebook-details when you
want one parser across platforms.
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.9s.
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-post-v2" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.facebook.com/reel/1662432368287618/" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "post": { "advertisement_status": false, "age_restriction_status": null, "author_id": null, "author_name": "Coldplay", "author_username": null, "caption": "Madonna, Shakira and BTS will co-headline the first-ever FIFA World Cup™ Final Halftime Show at the New York New Jersey Stadium on July 19. \n\nCurated by Coldplay’s Chris Martin and produced by Global Citizen, the show will raise funds for the FIFA Global Citizen Education Fund, improving access to quality education an… (+41 chars)", "child_content": null, "collaborators": null, "comment_count": 1478, "commenting_status": null, "content_code": "1662432368287618", "content_id": "1662432368287618", "content_language": null, "content_link": "https://www.facebook.com/reel/1662432368287618/", "content_type": "reel", "hashtags": [], "images": [ "https://scontent-iad3-1.xx.fbcdn.net/v/t51.71878-10/689887702_979312707788926_5933184563538820413_n.jpg?stp=dst-jpg_s526x296_tt6&_nc_cat=108&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=iychEBgLXu4Q7kNvwEStoAr&_nc_oc=Adq9f7jvHYCFTiBeSr33y5ekXNTObAgUjpwIoBLeXVvhClOKgNQ6nkQzerTsgV7g7nY&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=mKFh0… (+95 chars)" ], "like_count": 19075, "location": null, "media_height": null, "media_links": { "audio": null, "high": "https://video-iad6-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQMJsYzPjZHlrSxlS-fYZv_Nin6oKT6V8qnnuEm2bxUKAqG2uaiR7b8T9mHJ2fGPhlTiInAju7n1tpP2jjViFyA3mx6Rzvbo7kMBZtDXnw.mp4?_nc_cat=107&_nc_sid=8bf8fe&_nc_ht=video-iad6-1.xx.fbcdn.net&_nc_ohc=O6BKjcNC5B8Q7kNvwEvu9Vr&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI… (+384 chars)", "low": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m367/AQOnhVkaErZ2MPrLJbK7plHAhj44NEL7KCmd2TS0qCangxrAdNUJKNDtJI7HPG1tTfTSWnMEV52V3uG34BnfZAonx0kSce-rzDXbiSIoJA.mp4?_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=k-sqNX0ke6EQ7kNvwHTzmeL&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjM… (+385 chars)", "medium": null, "watermarked": null }, "media_width": null, "mentions": [], "music_information": { "album_art_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/417405452_1032707351558914_9033608049470446616_n.jpg?stp=c399.478.1250.1250a_cp0_dst-jpg_tt6&cstp=mx1250x1250&ctp=s64x64&_nc_cat=106&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=Levp9IO_IV4Q7kNvwEiAQcj&_nc_oc=AdoBvwYmQkDc2dXcJfytSsduRoYocARBcOKSXW2N7LqYGnlO3wxyVhvnSJgXnNrlSng&_nc_zt… (+138 chars)", "artist": "Coldplay", "id": "1054605626637539", "is_original": true, "sound_link": "https://www.facebook.com/reel/audio/1054605626637539", "title": "Original audio", "type": "original" }, "pinned_status": null, "play_count": 13000000, "profile_picture_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-1/417405452_1032707351558914_9033608049470446616_n.jpg?stp=c399.478.1250.1250a_cp0_dst-jpg_s40x40_tt6&_nc_cat=106&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=Levp9IO_IV4Q7kNvwG99P60&_nc_oc=AdoXXGesLyXaQFBlaazGqDspof35rJLEEAb8-J_imNWMCOHFP8eAcSPAXYD8q6hLwMg&_nc_zt=24&_nc_ht=scontent-i… (+117 chars)", "published_date": 1778731304, "share_count": 4858, "slideshow_status": false, "sponsorship_status": false, "tagged_users": [], "thumbnail_image": "https://scontent-iad3-1.xx.fbcdn.net/v/t51.71878-10/689887702_979312707788926_5933184563538820413_n.jpg?stp=dst-jpg_s526x296_tt6&_nc_cat=108&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=iychEBgLXu4Q7kNvwEStoAr&_nc_oc=Adq9f7jvHYCFTiBeSr33y5ekXNTObAgUjpwIoBLeXVvhClOKgNQ6nkQzerTsgV7g7nY&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=mKFh0… (+95 chars)", "video_link": "https://video-iad6-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQMJsYzPjZHlrSxlS-fYZv_Nin6oKT6V8qnnuEm2bxUKAqG2uaiR7b8T9mHJ2fGPhlTiInAju7n1tpP2jjViFyA3mx6Rzvbo7kMBZtDXnw.mp4?_nc_cat=107&_nc_sid=8bf8fe&_nc_ht=video-iad6-1.xx.fbcdn.net&_nc_ohc=O6BKjcNC5B8Q7kNvwEvu9Vr&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI… (+384 chars)", "view_count": 13000000 } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "facebook-post-v2", "billable": true, "duration_ms": 4403 }}