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

# Facebook Events API

> Find Facebook events by keyword search or event URL. One row per event with name, date, venue, host, attendance, and ticket link.

`POST /v1/data/facebook/events/run`

**Pricing:** $0.01 per event ($10.00 per 1,000).

Find events by keyword search, or pull events from specific Facebook event / explore / place URLs.

## Ways to call it

* **Search**: set `searchQueries` (optional: `maxResults`)
* **URL**: set `startUrls`

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**searchQueries** `string`

A keyword search query to discover events (e.g. Concert New York, tech conference Berlin).

**startUrls** `string`

A Facebook event, explore, search, or place URL to scrape events from.

Format e.g. `https://www.facebook.com/events/2702973076703822/`.

**maxResults** `integer`

Number of events to return. Use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/facebook/events/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "searchQueries": "Concert New York",
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/facebook/events/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "searchQueries": "Concert New York",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/facebook/events/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "searchQueries": "Concert New York",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one event, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `eventName` | Event Name | text |
| `eventUrl` | Event URL | text |
| `eventId` | Event ID | text |
| `description` | Description | text |
| `startDate` | Start Date | text |
| `dateTime` | Date Time | text |
| `duration` | Duration | text |
| `frequency` | Frequency | text |
| `isPast` | Is Past | boolean |
| `isCanceled` | Is Canceled | boolean |
| `isOnline` | Is Online | boolean |
| `going` | Going | number |
| `interested` | Interested | number |
| `host` | Host | text |
| `hosts` | Hosts | object\_array |
| `venueName` | Venue Name | text |
| `venueUrl` | Venue URL | text |
| `address` | Address | text |
| `street` | Street | text |
| `city` | City | text |
| `country` | Country | text |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |
| `category` | Category | text |
| `tickets` | Tickets | object |
| `externalLinks` | External Links | array |
| `coverImageUrl` | Cover Image URL | text |
| `imageCaption` | Image Caption | text |
| `occurrences` | Occurrences | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "facebook/events",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "tickets": {
        "label": "Tickets",
        "url": "https://bit.ly/3AbzmLH"
      },
      "frequency": "SINGLE",
      "eventUrl": "https://www.facebook.com/events/2702973076703822/",
      "city": "New York, NY, United States",
      "venueUrl": "https://www.facebook.com/pages/Madison-Square-Garden/176634819015202",
      "startDate": "2026-10-04T00:00:00.000Z",
      "eventId": "2702973076703822",
      "occurrences": [],
      "isCanceled": false,
      "isPast": false,
      "country": "United States",
      "externalLinks": [],
      "description": "Harry Styles is Back and in Concert. Catch him Live and Direct!",
      "longitude": -73.982671190754,
      "category": "Music",
      "interested": 1,
      "dateTime": "Saturday, October 3, 2026 at 8:00 PM EDT",
      "venueName": "Madison Square Garden",
      "imageCaption": "No photo description available.",
      "eventName": "Harry Styles Live in Concert New York at Madison Square Garden (Tickets)",
      "going": 1,
      "latitude": 40.719019884716,
      "street": null,
      "host": "Fidelity Music Lounge",
      "isOnline": false
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.