Facebook events

Structured Facebook event records: name, description, start time and duration, going, interested and responded counts, venue with address, organizers, ticket links and event type flags.

Use to pull details for specific Facebook events. Pass event URLs in startUrls, which is the reliable path. Keyword discovery through searchQueries is logged out and frequently returns no results, and a no-result run is still billed one event.

Price

$0.03 per event. That is the rate you pay for each event the call returns, so the total depends on how many it produces. Billing follows actual usage, so a call that returns fewer events costs less. discover and inspect also return a ceiling for your specific request, which is a maximum you will never be charged above.

Input

Field	Type	Notes
`maxEvents`	`integer`	Maximum events to extract. Leave unset for no limit. Billed per event at the highest per-unit price in this catalog.
`startUrls`	`array`	Plain URL strings, not objects. Event detail URLs such as https://www.facebook.com/events/1023978871819924 work best. Search and explore URLs are accepted but often return nothing.
`searchQueries`	`array`	Topic and/or place queries such as “Sport New York”. Unreliable while logged out: verified 2026-07-30 returning no results for several queries, and the run is still billed one event.

Goro forwards your input to the underlying tool unchanged, so any field the tool accepts works here even if it is not listed above.

Example

curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"facebook.events","input":{"maxEvents":3}}'

Response

One row of the response. Values are illustrative.

{
  "id": "1023978871819924",
  "url": "https://facebook.com/example-account/1023978871819924/",
  "name": "Mia Fontaine",
  "isPast": true,
  "duration": "4 hr",
  "imageUrl": "https://example.com/media/sample.jpg",
  "inputUrl": "https://facebook.com/example-account/1023978871819924",
  "isOnline": false,
  "location": {
    "id": "215609511542",
    "url": "https://facebook.com/example-account",
    "name": "Tomas Novak"
  },
  "eventType": "PUBLIC",
  "startTime": "Thu, 2 Feb 2023",
  "isCanceled": false,
  "usersGoing": 4537,
  "organizedBy": "Event by Live Nation Australia, Post Malone and Red Hot Chili Peppers",
  "utcStartDate": "2023-02-02T09:00:00.000Z",
  "externalLinks": [
    "http://telstra.com/tickets",
    "http://lvntn.com/RHCP23"
  ],
  "eventFrequency": "SINGLE",
  "usersResponded": 17528,
  "usersInterested": 12991,
  "dateTimeSentence": "Thursday 2 February 2023 from 20:00-00:00 AEDT"
}

Guide

CLI reference

API reference

Tools

Facebook events

Price

Input

Example

Response

​Price

​Input

​Example

​Response

Price

Input

Example

Response