Search APIs
Loading…
← API Store
Social

Facebook

Facebook

Facebook events search

GET /facebook/v1/events
Test this endpoint

Facebook'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

NameTypeDescription
qrequiredstringSearch text: a place ("New York, NY"), a topic or both. Example: New York, NY
datestringtoday, 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_fromstringStart of a date range (YYYY-MM-DD), instead of date.
date_tostringEnd of a date range (YYYY-MM-DD).
categorystringEvent 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_idstringA Facebook city page id (e.g. 108424279189115 for New York); /facebook/v1/event/details returns city_id for any event.
detailsbooleanfalse skips reading each event (faster; the search cards then carry only name, link and picture).
cursorstringValue of `next_cursor` from the previous page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "count": 8,
  "credits_used": 1,
  "events": [
    {
      "cover": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.99422-6/741475428_1972277686808866_4779253043498763247_n.png?stp=c150.0.1620.1080a_dst-jpg_tt6&cs…",
      "date": "Sat, Oct 24 at 5:00 PM MST and 2 more",
      "end_timestamp": null,
      "going": null,
      "id": "1772733450831521",
      "interested": null,
      "is_canceled": null,
      "is_online": false,
      "is_past": false,
      "location": "Scottsdale Quarter",
      "place_id": "1444027907770771",
      "price_range": null,
      "social_context": "1.7K interested · 1 going",
      "start_timestamp": 1790467200,
      "title": "Fall Concert Series",
      "url": "https://www.facebook.com/events/1772733450831521/"
    },
    {
      "cover": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.30808-6/656643674_1391170679710284_5997775752893723629_n.jpg?stp=c129.0.942.628a_dst-jpg_tt6&cstp…",
      "date": "Sat, Oct 24 at 7:30 PM EDT",
      "end_timestamp": null,
      "going": null,
      "id": "2320889298435938",
      "interested": null,
      "is_canceled": null,
      "is_online": false,
      "is_past": false,
      "location": "703 N Third Street, Wilmington, NC, United States, North Carolina 28401",
      "place_id": "1460629592764392",
      "price_range": null,
      "social_context": "1.2K interested · 55 going",
      "start_timestamp": 1792884600,
      "title": "Ghostbusters In Concert",
      "url": "https://www.facebook.com/events/2320889298435938/"
    },
    "… 6 more"
  ],
  "query": "concert"
}
Response fields (23)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.eventsarray
$.events[]object | string
$.events[].coverstring
$.events[].datestring
$.events[].end_timestampnull
$.events[].goingnull
$.events[].idstring
$.events[].interestednull
$.events[].is_cancelednull
$.events[].is_onlineboolean
$.events[].is_pastboolean
$.events[].locationstring
$.events[].place_idstring
$.events[].price_rangenull
$.events[].social_contextstring
$.events[].start_timestampinteger
$.events[].titlestring
$.events[].urlstring
$.querystring