Facebook

Event

A public event: its name, time, place, host and description.

GET/v1/facebook/events/details1 credit
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

2
event_idstringoptionalquery

An event's id: the digits in its link (facebook.com/events/<id>). Give event_id or url.

example: 2219404332228026

urlstringoptionalquery

An event's link: facebook.com/events/<id>, with anything after it. Give event_id or url.

max 300 chars

Response fields

25
dataobject

The result: one object, or a list for the endpoints that return several.

data.idstring

Facebook's id for the event: digits, written as text. The event details endpoint takes it.

data.urlstringnullable

The event's page.

data.namestringnullable

Its name.

data.starts_atstringnullable

When it starts.

format: date-time

data.whenstringnullable

When it is, as Facebook writes it (Fri, 23 Oct at 21:00 CDT), in the event's time zone.

data.placestringnullable

Where it is: a venue, an address or a city.

data.onlinebooleannullable

Whether it happens online.

data.hoststringnullable

Who hosts it.

data.host_urlstringnullable

The host's profile.

data.descriptionstringnullable

What the event says about itself. Only the event details endpoint gives it.

data.interestedintegernullable

People who said they're interested.

data.goingintegernullable

People who said they're going.

data.imagestringnullable

Its cover image's link.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/facebook/events/details?event_id=2219404332228026' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "url": "string",    "name": "string",    "starts_at": "2019-08-24T14:15:22Z",    "when": "string",    "place": "string",    "online": true,    "host": "string",    "host_url": "string",    "description": "string",    "interested": 0,    "going": 0,    "image": "string"  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}