Social Parse
PricingDashboard
Facebook

City events

Upcoming public events in a city, 12 a page, as Facebook's events page for the city lists them.

GET/v1/facebook/events1 credit

Headers

Get your API key
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

4
city_idstringoptionalquery

A city's id: the digits at the end of its events page's link (facebook.com/events/explore/<city>/<id>). Give city_id or url.

example: 111326725552547

urlstringoptionalquery

A city's events page: facebook.com/events/explore/<city>/<id>. Give city_id or url.

max 300 chars

timeenumoptionalquery

Only events in this time.

one of: today, tomorrow, this_weekend, this_week, next_week

cursorstringoptionalquery

For the next page: page.next_cursor from the page before. Send the other parameters again with it.

max 12000 chars

Response fields

25
dataarray

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?city_id=111326725552547' \  -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  }}

Event

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

Event search

Public events by name, as Facebook's logged-out event search finds them: 3 to 7 a page.