Social Fetch
Get API key
Facebook hub

Facebook Event API

Resolve a known event URL or event id to structured JSON — title, location, times, hosts, and attendance — in the same envelope as the rest of the Facebook tag.

GET /v1/facebook/events/details

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

`GET /v1/facebook/events/details` takes `eventId`, `url`, or both. At least one is required. Branch on `data.lookupStatus` before you write a row — `found` or `not_found`. On `found`, read `data.event` (eventId, url, name, description, cover, kind, privacy, and status flags), plus `schedule`, `location`, `attendance`, `tickets`, `hosts`, and `creator` when Facebook exposes them. Bill from `meta.creditsCharged`; the flat amount for this operation is on this page and in the OpenAPI note.

This is a single-event get. To search events by name, use `GET /v1/facebook/events/search`. All Facebook routes share one Social Fetch API key.

Facebook Event API FAQ

What does the Facebook Event API return?

A typed lookupStatus (found or not_found). When found, the payload can include event identity (eventId, url, name, description, coverPhotoUrl, kind, privacy, isOnline, isPast, isCanceled), schedule (startAt, duration, dayTimeSentence), location (name, address, city, coordinates, place), attendance counts, tickets, hosts, and creator. Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I fetch one Facebook event via API?

Send GET /v1/facebook/events/details with x-api-key and either eventId, url, or both. Prefer the public event URL when that is what you have; use eventId when the id is already known. See the API docs for parameters and examples.

How much does a Facebook event lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

Is event lookup the same as events search?

No. GET /v1/facebook/events/details returns one event when you already have an event URL or id. GET /v1/facebook/events/search finds events by name. Use search to discover candidates, then this route to enrich a specific event.

What happens for removed or unknown events?

The call still returns a typed lookupStatus. Unknown or unavailable events resolve as not_found with null event fields. Do not invent titles, times, or host data. Keep meta.requestId if you need support on a failed enrichment row.

Do I need a Facebook account or Graph API token for event details?

No. You authenticate to Social Fetch with an API key. The route reads publicly visible event details; it does not act on behalf of a Facebook account you manage.

Other Facebook endpoints