curl --request GET \
--url https://api.scraperize.com/v1/facebook/profile/reels \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/facebook/profile/reels"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/facebook/profile/reels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/facebook/profile/reels",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/facebook/profile/reels"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/facebook/profile/reels")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/facebook/profile/reels")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"reels": [
{
"videoId": "1549207066583030",
"postId": "1693264105493456",
"storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzoxNTQ5MjA3MDY2NTgzMDMw",
"url": "https://www.facebook.com/reel/1549207066583030",
"caption": "Greatness takes many forms 💪\n\nEsports World Cup is live in Paris with over 2000 players putting in the work to be the champion. \n\n@ewc_en",
"createdAt": "2026-07-21T13:55:43.000Z",
"createdTimestamp": 1784642143,
"durationSeconds": 84.28,
"width": 1918,
"height": 1080,
"thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-10/753225069_18753687136056421_3177299699481750751_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=s960x960&_nc_cat=1&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=cSbF-WIWHxYQ7kNvwH7QP-e&_nc_oc=AdoYmcE3eDPvgLHM21oqb_6Qdbku6hLEAfB4u6wGN-UcjfzcQ1wwCz13jzOD_E9PWFM&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQNm3oNn6Au4G0UVFHhKv8UmjwHeklqcPAytT8G_RHPTqw&oe=6AC99D99",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPJ1HokO3L-cfH7Rp1IpdhkhNnahtRm6Du01t1ApV1NvPPeTH4FsrhGBONIoOPu1qzYrz3TolBASuIgrH9Izpy8vVxzCV42vrmsEI1CIw.mp4?_nc_cat=104&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=f2NIETHXPsIQ7kNvwFbNNcd&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI3Ni5wcm9ncmVzc2l2ZV9oMjY0LWJhc2ljLWdlbjJfNzIwcCIsInhwdl9hc3NldF9pZCI6MTUwMjgwMzIzMTYxNzA5OCwiYXNzZXRfYWdlX2RheXMiOjc2LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6ODQsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&_nc_zt=28&oh=00_AQNWRPdNP3eWBymIZFWi8YP7RhEnKwgTuqR6pYCUhkoIXQ&oe=6AC9A2CA&bitrate=1407402&tag=progressive_h264-basic-gen2_720p",
"author": {
"id": "100044296486382",
"name": "Cristiano Ronaldo",
"url": "https://www.facebook.com/Cristiano",
"isVerified": true,
"avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQOu3xLcKt7fjzy00aDq1OhahijMIOjRJHwuCbRhfUCyyA&oe=6AC99D6E"
},
"audio": {
"trackTitle": "Cristiano Ronaldo · Original audio",
"isOriginalAudio": true,
"soundtrackId": "27127875796913092"
},
"stats": {
"reactions": 964277,
"comments": 25731,
"sharesLabel": "5.5K",
"viewsLabel": "11M"
},
"feedbackId": "ZmVlZGJhY2s6MTY5MzI2NDEwNTQ5MzQ1Ng=="
},
{
"videoId": "3536781926495651",
"postId": "1676592763827257",
"storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzozNTM2NzgxOTI2NDk1NjUx",
"url": "https://www.facebook.com/reel/3536781926495651",
"caption": "Toronto ❤️",
"createdAt": "2026-07-03T10:19:07.000Z",
"createdTimestamp": 1783073947,
"durationSeconds": 46.333,
"width": 1080,
"height": 1920,
"thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-10/731058572_18747860116056421_8724303327878739257_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s960x960&_nc_cat=108&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=U3Vrojl_Z8EQ7kNvwEqqxQN&_nc_oc=AdreWr9Fx16Tk9v1FQX2V7CRwL2AvvpZkrJIq4jePfWrEfnTleuhqsXIxzMAdIyvUtU&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQP9HtYfD_a5AbP1-m_BoLC20B3FSvkRjtrG6KUJ6A3QXA&oe=6AC985A9",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQO-uwD8zTWdMh66XhAY1vZwrnpixVp9CHN3rXY5ASkoZqf0CambWltI8D3ou-GhuupBQZ2CMiyls7USbK1qYoACClRRmYs6lrwH4DlnjA.mp4?_nc_cat=103&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=O48lZ98NxqQQ7kNvwFCsAkG&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMjIwMTAzNzEzNTExMjI0LCJhc3NldF9hZ2VfZGF5cyI6OTQsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjo0NiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&_nc_zt=28&oh=00_AQOACFyXpqQYLebolL3Y1X4NnaNf72JM-vZgbtygfmVhYw&oe=6AC974DB&bitrate=1222558&tag=progressive_h264-basic-gen2_720p",
"author": {
"id": "100044296486382",
"name": "Cristiano Ronaldo",
"url": "https://www.facebook.com/Cristiano",
"isVerified": true,
"avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQOu3xLcKt7fjzy00aDq1OhahijMIOjRJHwuCbRhfUCyyA&oe=6AC99D6E"
},
"audio": {
"trackTitle": "Cristiano Ronaldo · Original audio",
"isOriginalAudio": true,
"soundtrackId": "27667503352938519"
},
"stats": {
"reactions": 4909301,
"comments": 88623,
"sharesLabel": "45K",
"viewsLabel": "55M"
},
"feedbackId": "ZmVlZGJhY2s6MTY3NjU5Mjc2MzgyNzI1Nw=="
},
{
"videoId": "3316958438485267",
"postId": "1648599723293228",
"storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzozMzE2OTU4NDM4NDg1MjY3",
"url": "https://www.facebook.com/reel/3316958438485267",
"caption": null,
"createdAt": "2026-06-05T19:26:50.000Z",
"createdTimestamp": 1780687610,
"durationSeconds": 80,
"width": 1080,
"height": 1920,
"thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t51.71878-10/714444336_941839992222041_4405133798222772830_n.jpg?stp=dst-jpg_tt6&cstp=mx640x1136&ctp=s960x960&_nc_cat=111&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=c6vMxe7LV2UQ7kNvwFvBOuC&_nc_oc=AdqkEzbeiFLKdzq1wrCsD925_vAj9X_AYvi40C8XTW3wTXfrooENAUZ1rIINwgMidCo&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQPH6Fb153E-DkqIqRXJvlylyRN7T4WzpUUzdZcq2AHnzQ&oe=6AC96E31",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQOvgS2n18KyBhAdpKJzzmf5lObwXTcGZwX_8l5xh8L5hkGJUi-TwRM-5KuJ9NCs-vhJGkRrcD8-AyJ6aRCHs-9XUhw-tuTNLIIqnj0.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=AxSFQfUo6eUQ7kNvwHj0vWm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc4MDc1Njc5OTk2NTY3NiwiYXNzZXRfYWdlX2RheXMiOjEyMSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52e7e42631134bdd&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNjRBQUM0QTYwOEVEQUE0M0M5NTRBQzE1MEQ1MkNCQ192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzRBNEQ5NjEwMUYyRUIzNjI4Q0I1MDFEN0FBMjMyMTg1X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbYp_KH2OWpBhUCKAJDMywXQFQAAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdQJl5p0BAA&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&_nc_zt=28&oh=00_AQMXulFGu_oIIq-cSu4L9SIn5O_UMD8Aobvd1S3Kd2k7fQ&oe=6AC5A4EA&bitrate=982304&tag=dash_baseline_1_v1",
"author": {
"id": "100044296486382",
"name": "Cristiano Ronaldo",
"url": "https://www.facebook.com/Cristiano",
"isVerified": true,
"avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQOu3xLcKt7fjzy00aDq1OhahijMIOjRJHwuCbRhfUCyyA&oe=6AC99D6E"
},
"audio": {
"trackTitle": "Cristiano Ronaldo · Original audio",
"isOriginalAudio": true,
"soundtrackId": "27281705694793039"
},
"stats": {
"reactions": 1479660,
"comments": 18389,
"sharesLabel": "7.3K",
"viewsLabel": "17M"
},
"feedbackId": "ZmVlZGJhY2s6MTY0ODU5OTcyMzI5MzIyOA=="
}
],
"reelCount": 10,
"paging": {
"cursor": "AQHTUQrM2BH2vlehstnBx-XqoaTQKhZSCy7sqyZjNz8Ckax3xYFNy5Z584sdkVPT2j7nk2TremsLkJRqxR8vtYHr2g",
"hasNextPage": true
},
"fetchedAt": "2026-10-05T14:42:55.145Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Profile reels
Fetches a public Facebook page’s reels (from its /reels tab). Each reel includes its video id, permalink, caption, publish time, dimensions, thumbnail, a direct MP4 url, author, audio/soundtrack, and engagement stats (exact reactions & comments; Facebook-abbreviated share & view labels). Returns the first page plus a paging.cursor / paging.hasNextPage for the next page.
curl --request GET \
--url https://api.scraperize.com/v1/facebook/profile/reels \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/facebook/profile/reels"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/facebook/profile/reels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/facebook/profile/reels",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/facebook/profile/reels"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/facebook/profile/reels")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/facebook/profile/reels")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"reels": [
{
"videoId": "1549207066583030",
"postId": "1693264105493456",
"storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzoxNTQ5MjA3MDY2NTgzMDMw",
"url": "https://www.facebook.com/reel/1549207066583030",
"caption": "Greatness takes many forms 💪\n\nEsports World Cup is live in Paris with over 2000 players putting in the work to be the champion. \n\n@ewc_en",
"createdAt": "2026-07-21T13:55:43.000Z",
"createdTimestamp": 1784642143,
"durationSeconds": 84.28,
"width": 1918,
"height": 1080,
"thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-10/753225069_18753687136056421_3177299699481750751_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=s960x960&_nc_cat=1&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=cSbF-WIWHxYQ7kNvwH7QP-e&_nc_oc=AdoYmcE3eDPvgLHM21oqb_6Qdbku6hLEAfB4u6wGN-UcjfzcQ1wwCz13jzOD_E9PWFM&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQNm3oNn6Au4G0UVFHhKv8UmjwHeklqcPAytT8G_RHPTqw&oe=6AC99D99",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPJ1HokO3L-cfH7Rp1IpdhkhNnahtRm6Du01t1ApV1NvPPeTH4FsrhGBONIoOPu1qzYrz3TolBASuIgrH9Izpy8vVxzCV42vrmsEI1CIw.mp4?_nc_cat=104&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=f2NIETHXPsIQ7kNvwFbNNcd&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI3Ni5wcm9ncmVzc2l2ZV9oMjY0LWJhc2ljLWdlbjJfNzIwcCIsInhwdl9hc3NldF9pZCI6MTUwMjgwMzIzMTYxNzA5OCwiYXNzZXRfYWdlX2RheXMiOjc2LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6ODQsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&_nc_zt=28&oh=00_AQNWRPdNP3eWBymIZFWi8YP7RhEnKwgTuqR6pYCUhkoIXQ&oe=6AC9A2CA&bitrate=1407402&tag=progressive_h264-basic-gen2_720p",
"author": {
"id": "100044296486382",
"name": "Cristiano Ronaldo",
"url": "https://www.facebook.com/Cristiano",
"isVerified": true,
"avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQOu3xLcKt7fjzy00aDq1OhahijMIOjRJHwuCbRhfUCyyA&oe=6AC99D6E"
},
"audio": {
"trackTitle": "Cristiano Ronaldo · Original audio",
"isOriginalAudio": true,
"soundtrackId": "27127875796913092"
},
"stats": {
"reactions": 964277,
"comments": 25731,
"sharesLabel": "5.5K",
"viewsLabel": "11M"
},
"feedbackId": "ZmVlZGJhY2s6MTY5MzI2NDEwNTQ5MzQ1Ng=="
},
{
"videoId": "3536781926495651",
"postId": "1676592763827257",
"storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzozNTM2NzgxOTI2NDk1NjUx",
"url": "https://www.facebook.com/reel/3536781926495651",
"caption": "Toronto ❤️",
"createdAt": "2026-07-03T10:19:07.000Z",
"createdTimestamp": 1783073947,
"durationSeconds": 46.333,
"width": 1080,
"height": 1920,
"thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-10/731058572_18747860116056421_8724303327878739257_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s960x960&_nc_cat=108&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=U3Vrojl_Z8EQ7kNvwEqqxQN&_nc_oc=AdreWr9Fx16Tk9v1FQX2V7CRwL2AvvpZkrJIq4jePfWrEfnTleuhqsXIxzMAdIyvUtU&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQP9HtYfD_a5AbP1-m_BoLC20B3FSvkRjtrG6KUJ6A3QXA&oe=6AC985A9",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQO-uwD8zTWdMh66XhAY1vZwrnpixVp9CHN3rXY5ASkoZqf0CambWltI8D3ou-GhuupBQZ2CMiyls7USbK1qYoACClRRmYs6lrwH4DlnjA.mp4?_nc_cat=103&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=O48lZ98NxqQQ7kNvwFCsAkG&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMjIwMTAzNzEzNTExMjI0LCJhc3NldF9hZ2VfZGF5cyI6OTQsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjo0NiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&_nc_zt=28&oh=00_AQOACFyXpqQYLebolL3Y1X4NnaNf72JM-vZgbtygfmVhYw&oe=6AC974DB&bitrate=1222558&tag=progressive_h264-basic-gen2_720p",
"author": {
"id": "100044296486382",
"name": "Cristiano Ronaldo",
"url": "https://www.facebook.com/Cristiano",
"isVerified": true,
"avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQOu3xLcKt7fjzy00aDq1OhahijMIOjRJHwuCbRhfUCyyA&oe=6AC99D6E"
},
"audio": {
"trackTitle": "Cristiano Ronaldo · Original audio",
"isOriginalAudio": true,
"soundtrackId": "27667503352938519"
},
"stats": {
"reactions": 4909301,
"comments": 88623,
"sharesLabel": "45K",
"viewsLabel": "55M"
},
"feedbackId": "ZmVlZGJhY2s6MTY3NjU5Mjc2MzgyNzI1Nw=="
},
{
"videoId": "3316958438485267",
"postId": "1648599723293228",
"storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzozMzE2OTU4NDM4NDg1MjY3",
"url": "https://www.facebook.com/reel/3316958438485267",
"caption": null,
"createdAt": "2026-06-05T19:26:50.000Z",
"createdTimestamp": 1780687610,
"durationSeconds": 80,
"width": 1080,
"height": 1920,
"thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t51.71878-10/714444336_941839992222041_4405133798222772830_n.jpg?stp=dst-jpg_tt6&cstp=mx640x1136&ctp=s960x960&_nc_cat=111&ccb=1-7&_nc_sid=5fad0e&_nc_ohc=c6vMxe7LV2UQ7kNvwFvBOuC&_nc_oc=AdqkEzbeiFLKdzq1wrCsD925_vAj9X_AYvi40C8XTW3wTXfrooENAUZ1rIINwgMidCo&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQPH6Fb153E-DkqIqRXJvlylyRN7T4WzpUUzdZcq2AHnzQ&oe=6AC96E31",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQOvgS2n18KyBhAdpKJzzmf5lObwXTcGZwX_8l5xh8L5hkGJUi-TwRM-5KuJ9NCs-vhJGkRrcD8-AyJ6aRCHs-9XUhw-tuTNLIIqnj0.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=AxSFQfUo6eUQ7kNvwHj0vWm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc4MDc1Njc5OTk2NTY3NiwiYXNzZXRfYWdlX2RheXMiOjEyMSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52e7e42631134bdd&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNjRBQUM0QTYwOEVEQUE0M0M5NTRBQzE1MEQ1MkNCQ192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzRBNEQ5NjEwMUYyRUIzNjI4Q0I1MDFEN0FBMjMyMTg1X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbYp_KH2OWpBhUCKAJDMywXQFQAAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdQJl5p0BAA&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&_nc_zt=28&oh=00_AQMXulFGu_oIIq-cSu4L9SIn5O_UMD8Aobvd1S3Kd2k7fQ&oe=6AC5A4EA&bitrate=982304&tag=dash_baseline_1_v1",
"author": {
"id": "100044296486382",
"name": "Cristiano Ronaldo",
"url": "https://www.facebook.com/Cristiano",
"isVerified": true,
"avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=yo7XQcXoiMMQ7kNvwFgG_nB&_nc_oc=AdqG_hBVVSJyUHtnsjSA8nNNzizi_cq7a7ms0_YkvMtwqleeJS33lb7UeyFsO0f3EIs&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=v28u_oPPMT1pGv3427dNfQ&_nc_ss=7c289&oh=00_AQOu3xLcKt7fjzy00aDq1OhahijMIOjRJHwuCbRhfUCyyA&oe=6AC99D6E"
},
"audio": {
"trackTitle": "Cristiano Ronaldo · Original audio",
"isOriginalAudio": true,
"soundtrackId": "27281705694793039"
},
"stats": {
"reactions": 1479660,
"comments": 18389,
"sharesLabel": "7.3K",
"viewsLabel": "17M"
},
"feedbackId": "ZmVlZGJhY2s6MTY0ODU5OTcyMzI5MzIyOA=="
}
],
"reelCount": 10,
"paging": {
"cursor": "AQHTUQrM2BH2vlehstnBx-XqoaTQKhZSCy7sqyZjNz8Ckax3xYFNy5Z584sdkVPT2j7nk2TremsLkJRqxR8vtYHr2g",
"hasNextPage": true
},
"fetchedAt": "2026-10-05T14:42:55.145Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "The request was invalid.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source is temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}cache_max_age) are free.Copy for AI assistant
Copy for AI assistant
I want to make an API call to /v1/facebook/profile/reels. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/facebook/profile/reels
Description: Fetches a public Facebook page's reels (from its `/reels` tab). Each reel includes its video id, permalink, caption, publish time, dimensions, thumbnail, a direct MP4 url, author, audio/soundtrack, and engagement stats (exact reactions & comments; Facebook-abbreviated share & view labels). Returns the first page plus a `paging.cursor` / `paging.hasNextPage` for the next page.
Required Headers:
- x-api-key: Your API key
Parameters:
- url (string) [required]: Public Facebook page URL, e.g. https://www.facebook.com/Cristiano
- cursor (string): The `paging.cursor` from a previous call, to fetch the next page.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"reels": [
{
"videoId": "1549207066583030",
"postId": "1693264105493456",
"storyId": "UzpfSTEwMDA0NDI5NjQ4NjM4MjpWSzoxNTQ5MjA3MDY2NTgzMDMw",
"url": "https://www.facebook.com/reel/1549207066583030",
"caption": "Greatness takes many forms 💪\n\nEsports World Cup is live in Paris with over 2000 players putting in the work to be the champion. \n\n@ewc_en",
"createdAt": "2026-07-21T13:55:43.000Z",
"createdTimestamp": 1784642143,
"durationSeconds": 84.28,
"width": 1918,
"height": 1080,
"thumbnailUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t51.82787-10/753225069_18753687136056421_3177299699481750751_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=s960x960&_nc_cat=…",
"videoUrl": "https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPJ1HokO3L-cfH7Rp1IpdhkhNnahtRm6Du01t1ApV1NvPPeTH4FsrhGBONIoOPu1qzYrz3TolBASuIgrH9Izpy8vVxzCV42vrmsEI1CIw.mp4…",
"author": {
"id": "100044296486382",
"name": "Cristiano Ronaldo",
"url": "https://www.facebook.com/Cristiano",
"isVerified": true,
"avatarUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/722217916_1657518502401350_4679611467133898245_n.avif?stp=c0.54.1366.1366a_cp0_dst-avif&cstp=mx1366x1366&ctp=…"
},
"audio": {
"trackTitle": "Cristiano Ronaldo · Original audio",
"isOriginalAudio": true,
"soundtrackId": "27127875796913092"
},
"stats": {
"reactions": 964277,
"comments": 25731,
"sharesLabel": "5.5K",
"viewsLabel": "11M"
},
"feedbackId": "ZmVlZGJhY2s6MTY5MzI2NDEwNTQ5MzQ1Ng=="
}
],
"reelCount": 10,
"paging": {
"cursor": "AQHTUQrM2BH2vlehstnBx-XqoaTQKhZSCy7sqyZjNz8Ckax3xYFNy5Z584sdkVPT2j7nk2TremsLkJRqxR8vtYHr2g",
"hasNextPage": true
},
"fetchedAt": "2026-10-05T14:42:55.145Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
Public Facebook page URL, e.g. https://www.facebook.com/Cristiano
The paging.cursor from a previous call, to fetch the next page.
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.
1d, 3d, 7d, 14d, 30d