Social Fetch
Get API key
Facebook hub

Facebook City Events API

Turn a Facebook Events city explore URL into a page of event cards — name, time, place, and attendance — in the same envelope as the rest of the Facebook tag.

GET /v1/facebook/events

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

`GET /v1/facebook/events` takes a required Facebook Events explore URL (`/events/explore/{city-slug}/{location-id}`) and returns matching events under `data.events`. Optional `time` is `today`, `thisWeek`, or `nextWeek`; omit it to use the all-upcoming default. When `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` on the next call. Bill from `meta.creditsCharged`; the flat amount for this operation is on this page and in the OpenAPI note.

This is city explore, not name search and not a single-event lookup. To search events by name, use `GET /v1/facebook/events/search`. To hydrate one known event, use `GET /v1/facebook/events/details`. All Facebook routes share one Social Fetch API key.

Facebook City Events API FAQ

What does the Facebook City Events API return?

A page of event cards under data.events, the echoed explore URL, the requested time window (or null when omitted), totalEvents for this page, and pagination under data.page (hasMore, nextCursor). Each card can include id, url, name, cover, isOnline, isPast, isHappeningNow, startsAt, dayTimeLabel, place, kind, social counts, and ticketPriceLabel. Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

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

Send GET /v1/facebook/events with x-api-key and a required url pointing at a Facebook Events explore page, for example facebook.com/events/explore/saint-petersburg-florida/111326725552547. Optionally add time (today, thisWeek, or nextWeek) and cursor from a previous page. Full examples are in the API docs.

How much does listing Facebook city events 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. Each paginated page is a separate billed request.

Is city events the same as events search or a single-event lookup?

No. GET /v1/facebook/events lists events for one city from an explore URL. GET /v1/facebook/events/search finds events by name. GET /v1/facebook/events/details returns one event when you already have an event URL or id.

What does an empty events array mean?

An empty data.events array is a successful 200. It means no matching events in that time window for the requested city explore URL. This route has no lookupStatus field.

How does pagination work on Facebook city events?

When data.page.hasMore is true, pass data.page.nextCursor as the cursor query param on the next request. Keep the same explore URL and time filter across pages.

Do I need a Facebook account or Graph API token to list city events?

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

Other Facebook endpoints