Facebook Events

Search Facebook events

Search public Facebook events by keyword, optionally narrowed to a city, a date range and a category, with source continuation. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/facebook/events/search

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/facebook/events/search
  • Auth: API key in header x-api-key

Query parameters

querystring required

Public keyword/location query, 1–512 characters.

cursorstring

Opaque continuation from this service. Preserve it exactly; cursors are source- and route-specific.

location_idstring

Numeric Facebook city ID that pins results to one place, as found at the end of an events explore URL (/events/explore/<city>/<id>/).

date_fromstring

First event day to include, as YYYY-MM-DD.

date_tostring

Last event day to include, as YYYY-MM-DD; requires date_from and defaults to the same day.

category'art' | 'causes' | 'classics' | 'comedy' | 'crafts' | 'dance' | 'drinks' | 'film' | 'fitness' | 'food' | 'games' | 'gardening' | 'health' | 'home' | 'music' | 'networking' | 'parties' | 'religion' | 'shopping' | 'sports' | 'theatre' | 'wellness'

Event category: art, causes, classics, comedy, crafts, dance, drinks, film, fitness, food, games, gardening, health, home, music, networking, parties, religion, shopping, sports, theatre, wellness.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.