List Facebook city events

List Facebook events for a city by explore URL.

GET/v1/facebook/events
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
urlstringrequiredquery

Public Facebook Events explore URL for a city.

min 1 chars · max 4096 chars

timestringoptionalquery

Optional time window for events.

one of: today, thisWeek, nextWeek

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
35

Endpoint-specific response payload.

dataurl
string

Events explore URL evaluated for this response.

min 1 chars

datatime
stringnullable

Time window evaluated for this response; null when no filter was applied.

one of: today, thisWeek, nextWeek, null

Events returned for this page.

dataevents[]id
string

Stable event identifier.

min 1 chars

dataevents[]url
stringnullable

Canonical public event URL when available.

dataevents[]name
string

Event name.

min 1 chars

Cover image for the event.

dataevents[]coverphotoId
stringnullable

Cover photo identifier when available.

dataevents[]coverimageUrl
stringnullable

Cover image URL when available.

dataevents[]coveraccessibilityCaption
stringnullable

Cover image accessibility caption when available.

dataevents[]isOnline
booleannullable

Whether the event is online when available.

dataevents[]isPast
booleannullable

Whether the event has already ended when available.

dataevents[]isHappeningNow
booleannullable

Whether the event is happening now when available.

dataevents[]startsAt
stringnullable

Event start time as an ISO-8601 timestamp when available.

dataevents[]dayTimeLabel
stringnullable

Human-readable date and time label when available.

Venue or place associated with the event.

dataevents[]placeid
stringnullable

Place identifier for the venue when available.

dataevents[]placename
stringnullable

Display name of the venue when available.

dataevents[]kind
stringnullable

Event visibility kind when available, such as public or private.

Attendance context for the event.

dataevents[]socialsummary
stringnullable

Human-readable attendance summary when available.

dataevents[]socialinterestedCount
numbernullable

Number of people marked interested when available.

dataevents[]socialgoingCount
numbernullable

Number of people marked going when available.

dataevents[]socialwentCount
numbernullable

Number of people who went when available.

dataevents[]ticketPriceLabel
stringnullable

Ticket price range label when available.

datatotalEvents
integer

Number of events returned in this response.

≥ 0

Pagination information for the current response.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/facebook/events?url=https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547" \
  -H "x-api-key: YOUR_API_KEY"

Responses

City events listing.