> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook events

> Structured Facebook event records: name, description, start time and duration, going, interested and responded counts, venue with address, organizers, ticket li

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.

<Note>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.</Note>

## 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      | Required | 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](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.                                                   |

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

## Example

```bash theme={null}
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.

```json theme={null}
{
  "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"
}
```