Facebook Event Details API
Get a public Facebook event by its URL or id: name, description, start and end time, place, address, coordinates, hosts, attendance and interested counts. going_count is not on the logged-out page and is omitted. Deleted and private events redirect to a login and fail at 0 credits.
Quick start
cURL
curl --request GET 'https://api.fetchproof.com/v1/facebook/event/details?id=1705359837159507' \
--header 'x-api-key: YOUR_API_KEY' JavaScript
const response = await fetch("https://api.fetchproof.com/v1/facebook/event/details?id=1705359837159507", {
method: 'GET',
headers: {
'x-api-key': process.env.FETCHPROOF_API_KEY,
},
});
const data = await response.json();
console.log(data); Python
import os
import requests
response = requests.get(
"https://api.fetchproof.com/v1/facebook/event/details?id=1705359837159507",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json()) Go
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/facebook/event/details?id=1705359837159507", nil)
req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
} PHP
<?php
$ch = curl_init("https://api.fetchproof.com/v1/facebook/event/details?id=1705359837159507");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response; {
"success": true,
"credits_remaining": 100,
"credits_charged": 1,
"id": "1705359837159507",
"url": "https://www.facebook.com/events/1705359837159507/",
"name": "Ethan Regan",
"description": "Ethan Regan — Young Regan Tour with Lily Kershaw\nFine Line\nMonday, November 16, 2026\nAll Ages show\n\nTickets on sale Friday, June 5 → https://firstavenue.me/49x1R9d\n\n6:00 PM Doors\n7:00 PM Showtime",
"category": null,
"categories": [],
"is_online": false,
"is_past": true,
"event_kind": "PUBLIC_TYPE",
"privacy": "public",
"start_time": "2026-11-17T00:00:00.000Z",
"end_time": null,
"time_text": null,
"duration": null,
"price": null,
"ticket_url": null,
"ticket_source": null,
"ticket_provider": null,
"location_name": "Fine Line",
"address": "318 1st Ave N, Minneapolis, MN 55401",
"city": "Minneapolis, Minnesota",
"city_id": "106300959405546",
"latitude": 44.981770430395,
"longitude": -93.272286276774,
"attendance_count": 17,
"attendance_facepile_count": 0,
"can_view_members": true,
"host_context_text": "Event by Fine Line and First Avenue & 7th St Entry",
"hosts": [
{
"id": "100081805712155",
"name": "Fine Line",
"type": "User",
"url": "https://www.facebook.com/fineline",
"is_verified": false,
"profile_picture_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/351118061_962010508332045_6013110916803613828_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1080x1080&ctp=s40x40&ccb=1-7"
},
{
"id": "100064447433758",
"name": "First Avenue & 7th St Entry",
"type": "User",
"url": "https://www.facebook.com/firstavenue",
"is_verified": false,
"profile_picture_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/578251335_1228368949321341_7111270493589001754_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1080x1080&ctp=s40x40&ccb=1-7"
}
],
"host_names": [
"Fine Line",
"First Avenue & 7th St Entry"
],
"creator": {
"id": "100081805712155",
"name": "Fine Line",
"type": "User",
"url": null,
"is_verified": null,
"profile_picture_url": null
},
"description_links": [
"https://l.facebook.com/l.php?u=https%3A%2F%2Ffirstavenue.me%2F49x1R9d&h=AUAf0nZyiaNqms_5Mk6c7dyFhbXJW5aDybP9QAo8fdCNeg4nji1eqCn8RROMIg3J1dgNO_-SzFF36dIp711RoHr-Njk-HI-25DWDdJGl3FtZo7Vjqkv-blQyrWuPv5shhcPQ-Q_7SVhMBwZHVzbSaN4n4ZjDr7jT&s=1"
],
"is_viewer_host": false,
"is_canceled": false,
"cover_photo_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-6/722268091_993165893420259_8214256785399525884_n.jpg?stp=dst-jpg_tt6&cstp=mx681x341&ctp=s681x341&ccb=1-7",
"day_time_sentence": "Monday, November 16, 2026 at 6:00 PM CST",
"rsvp_style": "PUBLIC_RSVP_STYLE",
"event_place": {
"__typename": "Page",
"name": "Fine Line",
"contextual_name": "Fine Line",
"__isNode": "Page",
"id": "10256117927"
},
"price_info": null,
"current_start_timestamp": 1794873600,
"start_timestamp": 1794873600,
"start_time_formatted": "Mon, Nov 16"
} What it returns
- success boolean
- credits_remaining integer
- credits_charged integer
- id string
- url string
- name string
- description string
- category null
- categories array
- is_online boolean
Parameters
The ID of the event
The URL of the event, e.g. https://www.facebook.com/events/1705359837159507/
Use cases
- Get an event's time, place and hosts
- Map events by their coordinates
- Check how many people are interested in an event
- Enrich an event list with descriptions and addresses
Billing
Errors cost zero credits. Empty results follow this operation’s rules.
Default: 1 credit
An empty result costs 0 credits.
How charges are determined
Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.
A call that fails costs 0 credits. A result served from cache costs 0 credits.
`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.
A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).
A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Related Facebook endpoints
FAQ
How much does the Facebook Event Details API cost?
A call costs 1 credit by default. Errors cost 0 credits. New accounts get 100 free credits with no card. After that, credits come in one-time packs that never expire: 25,000 for $27 and 500,000 for $297 (plus any tax). There is no subscription.
What do I need to call it?
An API key in the x-api-key header. You don't need a Facebook account or developer app.
What does it return?
Typed JSON. Top-level fields include id, url, name, description, category and categories. The full schema and a real sample response are on this page and in the API reference.
Is this an official Facebook API?
No. Fetchproof is an unofficial API that returns public Facebook data only.