API referenceFacebook
Facebook profile
A Facebook page or profile, with its identity and counts.
The header record for a page or profile: name, category, follower and like counts, verification, description, and the links it publishes.
Address it by username, by numeric profile_id, or by full url. Pass
whichever you already have; passing the numeric id avoids a lookup.
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-profile" \ -H "Content-Type: application/json" \ -d '{ "username": "martin.garrix" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "bio": { "avatar": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-1/485909256_1218259256325736_3254876605054938336_n.jpg?stp=dst-jpg_tt6&cstp=mx1366x2048&ctp=s960x960&_nc_cat=102&ccb=1-7&_nc_sid=3ab345&_nc_ohc=XuMxe1Vg_8sQ7kNvwGRBghD&_nc_oc=AdpIe_p3-AUkeEyKOEL7XDu_NfmXBU-MhwaqgKS2WIIfj-_oBVScOrHT1F0qJRFyjIw&_nc_zt=24&_nc_ht=scontent-ia… (+116 chars)", "bio": "Musician/band", "is_verified": true, "likes_count": 15498263, "name": "Martin Garrix Reels", "talking_about_count": 67828, "username": "martin.garrix" }, "data": { "additional": { "avatar": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-1/485909256_1218259256325736_3254876605054938336_n.jpg?stp=dst-jpg_tt6&cstp=mx1366x2048&ctp=s960x960&_nc_cat=102&ccb=1-7&_nc_sid=3ab345&_nc_ohc=XuMxe1Vg_8sQ7kNvwGRBghD&_nc_oc=AdpIe_p3-AUkeEyKOEL7XDu_NfmXBU-MhwaqgKS2WIIfj-_oBVScOrHT1F0qJRFyjIw&_nc_zt=24&_nc_ht=scontent-ia… (+116 chars)", "bio": "Musician/band", "is_verified": true, "likes_count": 15498263, "name": "Martin Garrix Reels", "talking_about_count": 67828, "username": "martin.garrix" }, "main": [ { "caption": "official Fireflies video will be out today on YouTube!! very excited to finally share this @u2 ✨❤️", "comment_count": 133, "creator_handle": "Martin Garrix", "hashtags": [], "like_count": 5665, "post_id": "2168840770348474", "post_url": "https://www.facebook.com/reel/2168840770348474", "profile_picture_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-1/485909256_1218259256325736_3254876605054938336_n.jpg?stp=c83.54.1071.1072a_cp0_dst-jpg_s40x40_tt6&_nc_cat=102&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=XuMxe1Vg_8sQ7kNvwGRBghD&_nc_oc=AdpIe_p3-AUkeEyKOEL7XDu_NfmXBU-MhwaqgKS2WIIfj-_oBVScOrHT1F0qJRFyjIw&_nc_zt=24&_nc_ht=scontent-iad… (+115 chars)", "save_count": null, "share_count": 330, "thumbnail_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t51.82787-10/779944551_18634713955000351_121128383938375191_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=5fad0e&_nc_aid=0&_nc_ohc=Qa0sBVyvH_QQ7kNvwHkQHP4&_nc_oc=AdqMJSCH__bLzTMrSXmxh1guc-bLEAPzXS8qI14FQW_pR2XwI1MShIyIMxavp86HCzI&_nc_zt=23&_nc_ht=scontent-iad6-1.xx&_nc_gid=VC6wirVt5Qb-bxfFCyO… (+81 chars)", "upload_timestamp": 1787322426, "video_url": "https://video-iad6-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQM48_BskZ25jT5kWe3dQDcudjWjyfaylyfmQuRmJRZdIy-zPoMWbshhWmkjNTveu6Jm1FsXHaGHhrVzmECMchBjOGAlYvH7eFhwR8qMjQ.mp4?_nc_cat=100&_nc_sid=8bf8fe&_nc_ht=video-iad6-1.xx.fbcdn.net&_nc_ohc=GCZlb5m3XmAQ7kNvwEERWK9&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuMTA… (+377 chars)", "video_url_low_quality": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQMz3q3j0xwhekqpzcgm1JZ6OIzE5ix8Be-Wpv_ioUg741wZ-mGhXowLbfdCtZiO76GeB-Wmxp0q7BB5UCH7bVn9puk3RyAsUBIGqBHUQg.mp4?_nc_cat=104&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=mO5Krgrd_PUQ7kNvwGPsNQ0&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuNjM… (+379 chars)", "video_urls_by_quality": { "high": "https://video-iad6-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQM48_BskZ25jT5kWe3dQDcudjWjyfaylyfmQuRmJRZdIy-zPoMWbshhWmkjNTveu6Jm1FsXHaGHhrVzmECMchBjOGAlYvH7eFhwR8qMjQ.mp4?_nc_cat=100&_nc_sid=8bf8fe&_nc_ht=video-iad6-1.xx.fbcdn.net&_nc_ohc=GCZlb5m3XmAQ7kNvwEERWK9&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuMTA… (+377 chars)", "low": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQMz3q3j0xwhekqpzcgm1JZ6OIzE5ix8Be-Wpv_ioUg741wZ-mGhXowLbfdCtZiO76GeB-Wmxp0q7BB5UCH7bVn9puk3RyAsUBIGqBHUQg.mp4?_nc_cat=104&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=mO5Krgrd_PUQ7kNvwGPsNQ0&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuNjM… (+379 chars)", "medium": null, "watermarked": null }, "view_count": 191000 }, { "caption": "Fireflies in Romania!! ❤️❤️❤️", "comment_count": 182, "creator_handle": "Martin Garrix", "hashtags": [], "like_count": 7840, "post_id": "2123604541903268", "post_url": "https://www.facebook.com/reel/2123604541903268", "profile_picture_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-1/485909256_1218259256325736_3254876605054938336_n.jpg?stp=c83.54.1071.1072a_cp0_dst-jpg_s40x40_tt6&_nc_cat=102&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=XuMxe1Vg_8sQ7kNvwGRBghD&_nc_oc=AdpIe_p3-AUkeEyKOEL7XDu_NfmXBU-MhwaqgKS2WIIfj-_oBVScOrHT1F0qJRFyjIw&_nc_zt=24&_nc_ht=scontent-iad… (+115 chars)", "save_count": null, "share_count": 438, "thumbnail_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t51.82787-10/771998518_18630053989000351_1655616608433649162_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=106&ccb=1-7&_nc_sid=5fad0e&_nc_aid=0&_nc_ohc=hP6GwzW2VSMQ7kNvwHl9pDf&_nc_oc=AdqC7N31GZ3Dzb4vz6uii0e45bB_5GtIYXiYTap_JgLCdLuvWjMCy_gbCyThEOHOYH8&_nc_zt=23&_nc_ht=scontent-iad6-1.xx&_… (+107 chars)", "upload_timestamp": 1786285790, "video_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m367/AQPDXJc8nzKCCMM5vl6I70KvgJjnRWSMMBKkxrkD_5L5fPqYRYoEt86N17FmRV11UiRUUFA8TaEzdfNyXJoXxGuxJQjG0RO1oAOk7kt5wA.mp4?_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=07IBZwI7sSkQ7kNvwE2GzrQ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuNzI… (+378 chars)", "video_url_low_quality": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPocLb9-ec60Ov4dguAQ6lqRAJvud0ZAuaIF8ZDUjDBOYlmYszgx-f0m7jTm1vqj7dMQGpNlUbezLwn606Vb7LH0qs_H-K4az3U2ebXCQ.mp4?_nc_cat=108&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=DvS3au_Tm50Q7kNvwH2iP5G&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuMzY… (+377 chars)", "video_urls_by_quality": { "high": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m367/AQPDXJc8nzKCCMM5vl6I70KvgJjnRWSMMBKkxrkD_5L5fPqYRYoEt86N17FmRV11UiRUUFA8TaEzdfNyXJoXxGuxJQjG0RO1oAOk7kt5wA.mp4?_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=07IBZwI7sSkQ7kNvwE2GzrQ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuNzI… (+378 chars)", "low": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPocLb9-ec60Ov4dguAQ6lqRAJvud0ZAuaIF8ZDUjDBOYlmYszgx-f0m7jTm1vqj7dMQGpNlUbezLwn606Vb7LH0qs_H-K4az3U2ebXCQ.mp4?_nc_cat=108&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=DvS3au_Tm50Q7kNvwH2iP5G&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzIuMzY… (+377 chars)", "medium": null, "watermarked": null }, "view_count": 334000 }, "… 28 more items in the full response" ] }, "hasMore": true, "nextCursor": "AQHTDGT8e0MnFDPkb6LnlR2EGloTVuSSs4-PQUzIDIDbknAv4s1lqUs-pW6AaVNhSgE3EV0SMvG4jLqQnRBNG6Z3lw" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "facebook-profile", "billable": true, "duration_ms": 9151 }}