Get public Facebook profile information
curl --request GET \
--url https://api.scraperize.com/v1/facebook/profile \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/facebook/profile"
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', 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",
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"
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")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/facebook/profile")
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": {
"gated": false,
"profile": {
"id": "100064879894574",
"name": "The Metropolitan Museum of Art, New York",
"url": "https://www.facebook.com/metmuseum",
"username": null,
"alternateName": null,
"gender": "NEUTER",
"verified": true,
"categories": [
"Art Museums"
],
"profilePictureUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s480x480&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5",
"profilePicture": {
"small": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s200x200&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5",
"medium": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s320x320&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5",
"large": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s480x480&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5"
},
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/481991954_1056653546507299_950545646890195151_n.jpg?stp=dst-jpg_tt6&cstp=mx2048x1365&ctp=s2048x1365&_nc_cat=106&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=-0XqKelx9AsQ7kNvwH17zes&_nc_oc=AdryPaySitr7-syR7k_M8mFTJ-R4zRwpxE1n4Tt5KK7hcrHyrj_TOd7lroNn8lowPfo&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQLo_uztuUwQG3ntwAk4bmiGFzCIvntEZoaaT_pDvZ6UXg&oe=6AADCA00",
"followers": {
"count": 2400000,
"label": "2.4M followers"
},
"following": {
"count": 12,
"label": "12 following"
},
"likes": null,
"intro": null,
"contact": {
"phone": "+1 212-535-7710",
"email": null,
"website": "http://www.metmuseum.org/",
"address": "1000 5th Ave, New York, NY, United States, 10028"
},
"links": [
{
"type": "website",
"label": "Website",
"url": "http://www.metmuseum.org/",
"value": "http://www.metmuseum.org/"
}
],
"rating": "100% recommend (119,665 reviews)",
"isBusinessPage": false,
"otherDetails": [],
"businessHours": {
"status": "Closed now"
}
},
"fetchedAt": "2026-09-14T12:14:01.136Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"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 was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Facebook
Get public Facebook profile information
Fetches a public Facebook page/profile’s information (from its /about tab, logged-out): identity (name, id, url, username, verified, profile & cover photos), categories, follower/following counts, contact (phone, email, website, address), rating, and (optionally) the business hours status.
GET
/
v1
/
facebook
/
profile
Get public Facebook profile information
curl --request GET \
--url https://api.scraperize.com/v1/facebook/profile \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/facebook/profile"
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', 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",
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"
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")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/facebook/profile")
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": {
"gated": false,
"profile": {
"id": "100064879894574",
"name": "The Metropolitan Museum of Art, New York",
"url": "https://www.facebook.com/metmuseum",
"username": null,
"alternateName": null,
"gender": "NEUTER",
"verified": true,
"categories": [
"Art Museums"
],
"profilePictureUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s480x480&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5",
"profilePicture": {
"small": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s200x200&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5",
"medium": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s320x320&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5",
"large": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/347625751_651532197019438_2073582740604276353_n.jpg?stp=dst-jpg_tt6&cstp=mx1803x1803&ctp=s480x480&_nc_cat=103&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=SJQLywhEhTIQ7kNvwHyqo9Z&_nc_oc=Adq7u3FVKf5l81QjYfVMmkAU85LIsO_oabF5BT6v1d11bhOLiRJFSo0jDoO6oj76liw&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQK7dRCBYqWbvbEpNW7c8bVZW8bjub0XcqiweryQB_QZCg&oe=6AADB9B5"
},
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/481991954_1056653546507299_950545646890195151_n.jpg?stp=dst-jpg_tt6&cstp=mx2048x1365&ctp=s2048x1365&_nc_cat=106&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=-0XqKelx9AsQ7kNvwH17zes&_nc_oc=AdryPaySitr7-syR7k_M8mFTJ-R4zRwpxE1n4Tt5KK7hcrHyrj_TOd7lroNn8lowPfo&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=VLyKeBssAMLSg6pF62MG5w&_nc_ss=7f289&oh=00_AQLo_uztuUwQG3ntwAk4bmiGFzCIvntEZoaaT_pDvZ6UXg&oe=6AADCA00",
"followers": {
"count": 2400000,
"label": "2.4M followers"
},
"following": {
"count": 12,
"label": "12 following"
},
"likes": null,
"intro": null,
"contact": {
"phone": "+1 212-535-7710",
"email": null,
"website": "http://www.metmuseum.org/",
"address": "1000 5th Ave, New York, NY, United States, 10028"
},
"links": [
{
"type": "website",
"label": "Website",
"url": "http://www.metmuseum.org/",
"value": "http://www.metmuseum.org/"
}
],
"rating": "100% recommend (119,665 reviews)",
"isBusinessPage": false,
"otherDetails": [],
"businessHours": {
"status": "Closed now"
}
},
"fetchedAt": "2026-09-14T12:14:01.136Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"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 was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}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/metmuseum
Include the business's hours status (e.g. "Open now"/"Closed now"). Default true. (Logged-out, only the current status is available — not the per-day schedule.)
When true, a gated/age-restricted/unavailable page returns a limited response (gated: true) instead of a 404. Ignored for normal public profiles (always full). Default true.
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.
Available options:
1d, 3d, 7d, 14d, 30d