Search APIs
Loading…
← API Store
Social

Facebook

Facebook

Facebook event search

GET /facebook/v1/events/search
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. Example: concert
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. Example: 108424279189115
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": 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.eventsarray
$.events[]object | string
$.events[].covernull
$.events[].goingnull
$.events[].idstring
$.events[].interestednull
$.events[].is_onlinenull
$.events[].is_pastnull
$.events[].namestring
$.events[].placenull
$.events[].price_rangenull
$.events[].social_contextnull
$.events[].startnull
$.events[].start_timestampnull
$.events[].urlstring
$.events[].whennull
$.next_cursorstring
$.querystring