facebook

Events › Search

Returns public Facebook events matching a keyword, each with name, date sentence, venue, cover photo, interested and going counts, and online and past flags.

Use it to find events by topic anywhere; filter on is_past yourself, since the directory also returns events that have already happened.

10 credits per call.

Paginates by cursor: see Pagination.

get/v1/facebook/events/search

Request

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

Query parameters

querystring required
Example:dogs

Event name or keyword to search for.

cursorstring

Cursor returned by the previous response for pagination.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
dataConventionsData required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

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