> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/facebook/profiles-events>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/facebook/profiles-events.mdx>

---

# 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` 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.

## Request

- **Endpoint:** `GET /v1/facebook/profiles/events`
- **Credits:** 1 credit per successful request.
- **Input:** by profile or page URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/facebook/profiles/events/get)
- **Platform page:** [/platforms/facebook](https://www.socialfetch.dev/platforms/facebook)

## 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.