List Facebook profile events
List events hosted by a Facebook profile or Page.
Headers
Get your API keyAPI key (`sfk_...`)
Public Facebook profile or page URL.
min 1 chars · max 4096 chars
Opaque pagination cursor from a previous response.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the requested profile or page resolved for this request.
one of: found, not_found
Facebook events for the requested input. May be empty when `lookupStatus` is `found` and no public events are returned, or when `lookupStatus` is `not_found`.
Stable Facebook event id.
min 1 chars
Public Facebook URL for this event.
min 1 chars
Event title when available.
ISO-8601 UTC timestamp for the scheduled start when available.
Localized date and time sentence Facebook shows for the event.
Whether the event is marked canceled.
Whether the event is happening now.
Whether the event is online.
Whether the event has already ended.
Facebook event kind when available, such as a public event.
Event creator when available.
Facebook id for the event creator when available.
Display name for the event creator.
Public Facebook URL for the event creator when available.
Event place when available.
Facebook id for the event place when available.
Place name shown for the event when available.
City name for the event place when available.
Source-platform CDN URL for the cover photo when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. Null when no syntactically usable URL is available.
Source-platform CDN URL for the cover video when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. Null when no syntactically usable URL is available.
Pagination state for the current response.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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/profiles/events?url=https://www.facebook.com/brickyardoldtown" \
-H "x-api-key: YOUR_API_KEY"Responses
Facebook events for the requested profile or page.