Social Fetch
Get API key
Facebook hub

Facebook Page events API

List public events hosted by a Facebook Page — titles, start times, places, and creators — with cursor pagination in the shared Social Fetch envelope.

GET /v1/facebook/profiles/events

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

`GET /v1/facebook/profiles/events` lists events hosted or listed by a public Facebook Page. Pass a full public `url` query param. On a completed lookup, read `data.lookupStatus`, then `data.events` and `data.page`. Each event can include id, public url, name, startAt (ISO-8601), dayTimeSentence, cancellation and online flags, eventKind, creator, place, and cover media URLs when Facebook exposes them. When `data.page.hasMore` is true, pass `data.page.nextCursor` as the `cursor` query param on the next call. Bill from `meta.creditsCharged`.

`found` plus an empty `events` array is the usual empty outcome. It can mean the Page has no public events, or that the URL did not resolve — this route cannot tell those apart. Use `GET /v1/facebook/profiles` when you need an existence check. This route is the Page events tab, not city-wide event explore and not event search by name. A single event by URL or id is a separate event-detail route when available.

Facebook Page events API FAQ

How do I list Facebook events for a Page via API?

Call `GET /v1/facebook/profiles/events` with your Social Fetch API key (`x-api-key`) and a public Facebook Page `url` query param. Read `data.lookupStatus`, then `data.events` and `data.page`. See the API docs for parameters and examples.

How much does the Facebook Page events endpoint cost?

1 credit per successful list page. Always bill from `meta.creditsCharged` on the response. Each paginated page is a separate billed request.

How does pagination work on Facebook Page events?

Each response includes `data.page.nextCursor` and `data.page.hasMore`. When `hasMore` is true, pass `nextCursor` as the `cursor` query param on the next request. The cursor is opaque.

What fields are in each Facebook Page event?

Items can include id, public url, name, startAt (ISO-8601), dayTimeSentence, isCanceled, isHappeningNow, isOnline, isPast, eventKind, creator (id, name, url), place (id, name, city), and cover photo/video URLs when Facebook exposes them.

What does lookupStatus mean on Facebook Page events?

`found` is the usual success, including when `data.events` is empty. An empty list can mean the Page has no public events, or that the URL did not resolve — this route cannot tell those apart. `not_found` appears only when upstream explicitly signals a miss. For a Page existence check, call `GET /v1/facebook/profiles`.

Page events vs city events vs event search?

Use this route to page a Page's own events tab. City-wide explore and name search are separate Facebook events routes. Do not pass `facebook.com/events/explore/…` here.

Do I need Meta Graph API access or page admin rights?

No. Social Fetch returns publicly visible events for enrichment-style lookups. Meta's Graph and Marketing APIs are for assets and ads accounts you control or that authorize your app.

Other Facebook endpoints