Social Fetch
Start for freeStart free
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 the platform 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