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.
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 10.2s.
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 }}