curl --request GET \
--url https://api.scraperize.com/v1/facebook/profile/events \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/facebook/profile/events"
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/events', 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/events",
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/events"
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/events")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/facebook/profile/events")
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": {
"events": [
{
"id": "668090121966465",
"name": "Tech For Good",
"url": "https://www.facebook.com/events/668090121966465/",
"startTimestamp": 1696946400,
"startDate": "2023-10-10T14:00:00.000Z",
"dayTimeSentence": "Tue, 10 Oct 2023",
"isPast": true,
"isHappeningNow": false,
"isCanceled": false,
"isOnline": true,
"eventKind": "PUBLIC_TYPE",
"onlineEventType": "FB_LIVE",
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/384120671_713131144187494_3360755611233295705_n.png?stp=c118.0.1044.720a_dst-png&cstp=mx1044x720&ctp=s235x165&_nc_cat=110&ccb=1-7&_nc_sid=4bdd9b&_nc_ohc=o9XgitxjxooQ7kNvwE7i5px&_nc_oc=Adph27MG0CNUT4_roGrc3ftk5vgsEQ1a3FMfUeUFSrDYpwAwPD01G_L-FC729dixoFs&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=q6UGiI8rHSsOiUEpAXDOQA&_nc_ss=7f289&oh=00_AQKRg09UqNsnMludZc2s6mGCj_1d-ONUvpGpEJZRlno5aQ&oe=6AADA61B",
"coverVideoUrl": null,
"place": null,
"creator": {
"id": "100064718437596",
"name": "Web Summit",
"url": "https://www.facebook.com/WebSummitHQ"
}
},
{
"id": "563963522351024",
"name": "Test",
"url": "https://www.facebook.com/events/563963522351024/",
"startTimestamp": 1677600900,
"startDate": "2023-02-28T16:15:00.000Z",
"dayTimeSentence": "Tue, 28 Feb 2023",
"isPast": true,
"isHappeningNow": false,
"isCanceled": false,
"isOnline": true,
"eventKind": "PUBLIC_TYPE",
"onlineEventType": "FB_LIVE",
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/331416647_3352736264991172_6745313760654182826_n.png?stp=c118.0.1044.720a_dst-png&cstp=mx1044x720&ctp=s235x165&_nc_cat=102&ccb=1-7&_nc_sid=4bdd9b&_nc_ohc=QG4Hj_7B6J8Q7kNvwHvTN59&_nc_oc=AdrH8NPX-cP7iyIXimXmkbBBVDUbrZZAuPqBQ2L2WxTG4ybyRwKHwZGV28gWQBkPrQA&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=q6UGiI8rHSsOiUEpAXDOQA&_nc_ss=7f289&oh=00_AQK29dzKQ8gqXzqZ4AmiBiPuUYreWP_uenP6sbTJWPoiyw&oe=6AADA549",
"coverVideoUrl": null,
"place": null,
"creator": {
"id": "100064718437596",
"name": "Web Summit",
"url": "https://www.facebook.com/WebSummitHQ"
}
},
{
"id": "1144488746245969",
"name": "Restream Test",
"url": "https://www.facebook.com/events/1144488746245969/",
"startTimestamp": 1677586500,
"startDate": "2023-02-28T12:15:00.000Z",
"dayTimeSentence": "Tue, 28 Feb 2023",
"isPast": true,
"isHappeningNow": false,
"isCanceled": false,
"isOnline": true,
"eventKind": "PUBLIC_TYPE",
"onlineEventType": "FB_LIVE",
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/333968926_594306715889858_5541687746335947839_n.png?stp=c118.0.1044.720a_dst-png&cstp=mx1044x720&ctp=s235x165&_nc_cat=100&ccb=1-7&_nc_sid=4bdd9b&_nc_ohc=-DR-Jqs1ol4Q7kNvwFBQDzs&_nc_oc=AdpKIFpGeuQ9OvqA1VY8Hky0Id_hFfAUiDFhfnsLF8bvpH_8crvbvYI9nF5ukfbuKZA&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=q6UGiI8rHSsOiUEpAXDOQA&_nc_ss=7f289&oh=00_AQIwavwVqizU-CVgf9wQXo2WJwEH6BtEuKDWROB_Iq94ug&oe=6AADC136",
"coverVideoUrl": null,
"place": null,
"creator": {
"id": "100064718437596",
"name": "Web Summit",
"url": "https://www.facebook.com/WebSummitHQ"
}
}
],
"eventCount": 8,
"totalCount": 53,
"paging": {
"cursor": "AQHTzpw3vw12YnEoNjwAzXeqFikbX05iBiF0cksdsggf0zIprzBbHWTVou_cF6-tujzH3CUxj4zFGrXccF2jdvv6aQ",
"hasNextPage": true
},
"fetchedAt": "2026-09-14T12:13:50.211Z"
},
"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 was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Get a public Facebook page's events
Fetches a public Facebook page’s events (from its /events tab, logged-out). Each event includes its name, url, start time (unix + ISO + the human date line), past/online/canceled flags, kind, cover photo, place (name/type/city/coords when present), and creator. Returns the batch on the initial page load plus a paging.cursor / paging.hasNextPage for the next page.
curl --request GET \
--url https://api.scraperize.com/v1/facebook/profile/events \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/facebook/profile/events"
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/events', 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/events",
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/events"
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/events")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/facebook/profile/events")
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": {
"events": [
{
"id": "668090121966465",
"name": "Tech For Good",
"url": "https://www.facebook.com/events/668090121966465/",
"startTimestamp": 1696946400,
"startDate": "2023-10-10T14:00:00.000Z",
"dayTimeSentence": "Tue, 10 Oct 2023",
"isPast": true,
"isHappeningNow": false,
"isCanceled": false,
"isOnline": true,
"eventKind": "PUBLIC_TYPE",
"onlineEventType": "FB_LIVE",
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/384120671_713131144187494_3360755611233295705_n.png?stp=c118.0.1044.720a_dst-png&cstp=mx1044x720&ctp=s235x165&_nc_cat=110&ccb=1-7&_nc_sid=4bdd9b&_nc_ohc=o9XgitxjxooQ7kNvwE7i5px&_nc_oc=Adph27MG0CNUT4_roGrc3ftk5vgsEQ1a3FMfUeUFSrDYpwAwPD01G_L-FC729dixoFs&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=q6UGiI8rHSsOiUEpAXDOQA&_nc_ss=7f289&oh=00_AQKRg09UqNsnMludZc2s6mGCj_1d-ONUvpGpEJZRlno5aQ&oe=6AADA61B",
"coverVideoUrl": null,
"place": null,
"creator": {
"id": "100064718437596",
"name": "Web Summit",
"url": "https://www.facebook.com/WebSummitHQ"
}
},
{
"id": "563963522351024",
"name": "Test",
"url": "https://www.facebook.com/events/563963522351024/",
"startTimestamp": 1677600900,
"startDate": "2023-02-28T16:15:00.000Z",
"dayTimeSentence": "Tue, 28 Feb 2023",
"isPast": true,
"isHappeningNow": false,
"isCanceled": false,
"isOnline": true,
"eventKind": "PUBLIC_TYPE",
"onlineEventType": "FB_LIVE",
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/331416647_3352736264991172_6745313760654182826_n.png?stp=c118.0.1044.720a_dst-png&cstp=mx1044x720&ctp=s235x165&_nc_cat=102&ccb=1-7&_nc_sid=4bdd9b&_nc_ohc=QG4Hj_7B6J8Q7kNvwHvTN59&_nc_oc=AdrH8NPX-cP7iyIXimXmkbBBVDUbrZZAuPqBQ2L2WxTG4ybyRwKHwZGV28gWQBkPrQA&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=q6UGiI8rHSsOiUEpAXDOQA&_nc_ss=7f289&oh=00_AQK29dzKQ8gqXzqZ4AmiBiPuUYreWP_uenP6sbTJWPoiyw&oe=6AADA549",
"coverVideoUrl": null,
"place": null,
"creator": {
"id": "100064718437596",
"name": "Web Summit",
"url": "https://www.facebook.com/WebSummitHQ"
}
},
{
"id": "1144488746245969",
"name": "Restream Test",
"url": "https://www.facebook.com/events/1144488746245969/",
"startTimestamp": 1677586500,
"startDate": "2023-02-28T12:15:00.000Z",
"dayTimeSentence": "Tue, 28 Feb 2023",
"isPast": true,
"isHappeningNow": false,
"isCanceled": false,
"isOnline": true,
"eventKind": "PUBLIC_TYPE",
"onlineEventType": "FB_LIVE",
"coverPhotoUrl": "https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/333968926_594306715889858_5541687746335947839_n.png?stp=c118.0.1044.720a_dst-png&cstp=mx1044x720&ctp=s235x165&_nc_cat=100&ccb=1-7&_nc_sid=4bdd9b&_nc_ohc=-DR-Jqs1ol4Q7kNvwFBQDzs&_nc_oc=AdpKIFpGeuQ9OvqA1VY8Hky0Id_hFfAUiDFhfnsLF8bvpH_8crvbvYI9nF5ukfbuKZA&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=q6UGiI8rHSsOiUEpAXDOQA&_nc_ss=7f289&oh=00_AQIwavwVqizU-CVgf9wQXo2WJwEH6BtEuKDWROB_Iq94ug&oe=6AADC136",
"coverVideoUrl": null,
"place": null,
"creator": {
"id": "100064718437596",
"name": "Web Summit",
"url": "https://www.facebook.com/WebSummitHQ"
}
}
],
"eventCount": 8,
"totalCount": 53,
"paging": {
"cursor": "AQHTzpw3vw12YnEoNjwAzXeqFikbX05iBiF0cksdsggf0zIprzBbHWTVou_cF6-tujzH3CUxj4zFGrXccF2jdvv6aQ",
"hasNextPage": true
},
"fetchedAt": "2026-09-14T12:13:50.211Z"
},
"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 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/WebSummitHQ
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