Facebook event search
GET /facebook/v1/events/searchFacebook's logged-out event search, 10 events per page, with Facebook's own filters. The search cards carry only name and picture, so each event is read for its dates, place, cover and counts (details=false skips that). available_filters lists the date and category values Facebook offers for the query. Pagination: pass next_cursor back as cursor; it is null on the last page. A query without a location (e.g. "concert") returns fewer results; add location_id or put the place in q.
Every response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Search text. Example: concert |
date | string | today, tomorrow, this_week, this_weekend, next_week, a day (YYYY-MM-DD) or a range (YYYY-MM-DD~YYYY-MM-DD). Example: this_weekend |
date_from | string | Start of a date range (YYYY-MM-DD), instead of date. |
date_to | string | End of a date range (YYYY-MM-DD). |
category | string | Event category: art, causes, comedy, crafts, dance, drinks, film, fitness, food, games, gardening, health, home, literature, music, networking, other, party, religion, shopping, sports, theater, wellness (or a Facebook category id). |
location_id | string | A Facebook city page id (e.g. 108424279189115 for New York); /facebook/v1/event/details returns city_id for any event. Example: 108424279189115 |
details | boolean | false skips reading each event (faster; the search cards then carry only name, link and picture). |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 7,
"credits_used": 1,
"events": [
{
"cover": null,
"going": null,
"id": "1038934472394730",
"interested": null,
"is_online": null,
"is_past": null,
"name": "A Ukrainian Double Bill! ",
"place": null,
"price_range": null,
"social_context": null,
"start": null,
"start_timestamp": null,
"url": "https://www.facebook.com/events/1038934472394730/",
"when": null
},
{
"cover": null,
"going": null,
"id": "1629759145566400",
"interested": null,
"is_online": null,
"is_past": null,
"name": "CINCINNATI SANDBOX featuring Kristin Lee, violin and Sandbox Percussion",
"place": null,
"price_range": null,
"social_context": null,
"start": null,
"start_timestamp": null,
"url": "https://www.facebook.com/events/1629759145566400/",
"when": null
},
"… 5 more"
],
"next_cursor": "eyJxIjoiY29uY2VydCIsImMiOiJ7XCJwYWdlX251bWJlclwiOjAsXCJmbG93X2N1cnNvcnNfc2VyaWFsaXplZFwiOntcIklOVEVSTkFMX0RFQlVHX01PRFVMRVwiOlwie31cIixcIlNF…",
"query": "concert"
} Response fields (22)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.events | array |
$.events[] | object | string |
$.events[].cover | null |
$.events[].going | null |
$.events[].id | string |
$.events[].interested | null |
$.events[].is_online | null |
$.events[].is_past | null |
$.events[].name | string |
$.events[].place | null |
$.events[].price_range | null |
$.events[].social_context | null |
$.events[].start | null |
$.events[].start_timestamp | null |
$.events[].url | string |
$.events[].when | null |
$.next_cursor | string |
$.query | string |