Facebook Event API
Full details for one public Facebook event: description, start and end time, venue with coordinates, host and ticket price range. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.
Try it
Prefilled with the request that produced the example below. No key yet? Get a free key.
Request
GET
/v1/facebook/event| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | Event URL or numeric event id |
Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).
curl
curl "$API/v1/facebook/event?url=https%3A%2F%2Fwww.facebook.com%2Fevents%2F1096800594759087%2F&cache_max_age=7d" \
-H "x-api-key: $KEY"JavaScript
const query = new URLSearchParams({
url: 'https://www.facebook.com/events/1096800594759087/',
cache_max_age: '7d',
});
const response = await fetch(`${API}/v1/facebook/event?${query}`, {
headers: { 'x-api-key': KEY },
});
const body = await response.json();
if (!body.success) throw new Error(body.error.code);
// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);Python
import os, httpx
r = httpx.get(
f"{os.environ['API']}/v1/facebook/event",
params={
"url": "https://www.facebook.com/events/1096800594759087/",
"cache_max_age": "7d",
},
headers={"x-api-key": os.environ["KEY"]},
timeout=30,
)
body = r.json()
if not body["success"]:
raise RuntimeError(body["error"]["code"])
print(body["data"], body["meta"]["creditsCharged"])Example response
Captured on , with raw removed and lists cut to two items. A live call returns current data.
response
{
"success": true,
"data": {
"platform": "facebook",
"id": "1096800594759087",
"name": "Teens Take The Met! (Ages 13–18) ",
"url": "https://www.facebook.com/events/1096800594759087/",
"description": "Grab your friends and celebrate the 10th anniversary of Teens Take The Met! Drop in for teen-only activities across the Museum, including art making, performances, music, and more. Discover what you can also do at over 50 NYC cultural and community organizations. \n\nDoors open at 4 pm. Teens Take The Met! is free and open to all teens 13+ with a middle or high school ID. Just show up or RSVP now to get a free ticket to beat the line: met.org/MetTeens2024\n\nIf you're a chaperone who'd like to come with a group of 10 or more teens, please email teenprograms@metmuseum.org for instructions.\n\nA schedule of events will be available in English and Spanish.\n\nThis event will be photographed, filmed, and/or recorded. By your presence at the event, you consent to the photography, filming, and use of your image and/or voice. \n\nTeens Take The Met! is a Teen Night co-organized with over 50 community partners. Visit our website to see all participating organizations: met.org/MetTeens2024",
"startsAt": "2024-05-31T20:00:00.000Z",
"endsAt": null,
"timeText": "Friday, May 31, 2024 at 4:00 PM – 8:00 PM EDT",
"isOnline": false,
"isCanceled": false,
"isPast": true,
"place": {
"id": "842192351286754",
"name": "1000 5th Ave, New York, NY, United States, New York 10028",
"address": "The Metropolitan Museum of Art, 1000 5th Ave, New York, NY 10028, United States",
"latitude": 40.77942,
"longitude": -73.96342
},
"hostId": "100064879894574",
"hostName": "The Metropolitan Museum of Art, New York",
"hostUrl": "https://www.facebook.com/metmuseum",
"thumbnailUrl": "https://scontent-nrt1-2.xx.fbcdn.net/v/t39.30808-6/485768529_1070082381831082_888722756516245932_n.jpg?stp=dst-jpg_tt6&cstp=mx1920x1080&ctp=s960x960&_nc_cat=102&ccb=1-7&_nc_sid=75d36f&_nc_ohc=cr4e7czKSdUQ7kNvwG-b9Lj&_nc_oc=AdpkUo1kERUSp8Ffy2S1aqx4i0fqIIZayACtylowexKsAEJYnnOV-Zb92MBAI4xkwSA&_nc_zt=23&_nc_ht=scontent-nrt1-2.xx&_nc_gid=j3abvfotApGkxg-HlM6Paw&_nc_ss=70289&oh=00_AQNQbuQOrrQfO9hBjkkml1qx7plb_7HZiQ306BfaLdcNOQ&oe=6ADDE9CE",
"ticketPriceText": null,
"interestedCount": 100,
"fetchedAt": "2026-10-21T01:58:31.730Z"
},
"meta": {
"platform": "facebook",
"endpoint": "facebook.event",
"creditsCharged": 1,
"cached": false,
"cacheAgeSeconds": null,
"durationMs": 2461,
"requestId": "req_lhuy516qqlnzx2yqes99"
}
}Returns
Returns an object with platform, id, name, url, description, startsAt, endsAt, timeText, isOnline, isCanceled, isPast, place, hostId, hostName, hostUrl, thumbnailUrl, ticketPriceText, interestedCount, fetchedAt.
Fields
| Field | Type | Present | Description |
|---|---|---|---|
| platform | "facebook" | always | |
| id | string | always | |
| name | string | null | always | |
| url | string | always | |
| description | string | null | always | |
| startsAt | string | null | always | ISO 8601, UTC. |
| endsAt | string | null | always | ISO 8601, UTC. Null when the event has no end time. |
| timeText | string | null | always | Facebook's own rendering of the time, e.g. "Sat, Sep 5 at 3:00 PM MDT". It carries the event's LOCAL timezone, which the epoch timestamps do not. |
| isOnline | boolean | null | always | |
| isCanceled | boolean | null | always | |
| isPast | boolean | null | always | |
| place | object | null | always | |
| place.id | string | null | always | |
| place.name | string | null | always | |
| place.address | string | null | always | |
| place.latitude | number | null | always | |
| place.longitude | number | null | always | |
| hostId | string | null | always | |
| hostName | string | null | always | |
| hostUrl | string | null | always | |
| thumbnailUrl | string | null | always | |
| ticketPriceText | string | null | always | |
| interestedCount | number | null | always | People who marked the event Interested or Going. In list results above a thousand, Facebook's rounded figure ("1.2K"). |
| fetchedAt | string | always |
Cost and behaviour
| Credits | 1 per live request, 0 on a cache hit |
| Cacheable | yes: cache_max_age accepts a cached copy |
| Batchable | yes: usable as a target in POST /v1/jobs/batch |
| Subscribable | yes: as often as every 3600 seconds, firing a webhook only on a change |
Other Facebook endpoints
- /v1/facebook/ad-library/ad Ad details
- /v1/facebook/ad-library/ad-transcript Ad video transcript
- /v1/facebook/ad-library/advertisers Find advertisers running ads
- /v1/facebook/ad-library/page-ads All ads for one advertiser
- /v1/facebook/ad-library/search Search the Meta Ad Library
- /v1/facebook/city-events Get the events of a city
- /v1/facebook/comment-replies Replies to a comment
- /v1/facebook/events/search Search public events