# Facebook Events

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

**Pricing:** $10 / 1k events

**Endpoint:** `POST /api/v1/agents/facebook/events/run`

**Auth:** `Authorization: Bearer mk_live_...`

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `searchQueries` | array | No | Keywords to discover events, one per line (e.g. Concert New York, tech conference Berlin). |
| `startUrls` | array | No | Facebook event, explore, search, or place URLs, one per line. |
| `maxResults` | integer | No | Number of events to return per search keyword or URL. |

## Example

```bash
curl -X POST https://api.mindcase.co/api/v1/agents/facebook/events/run \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{}}'
```

```python
import requests

resp = requests.post(
    "https://api.mindcase.co/api/v1/agents/facebook/events/run",
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
    json={"params": {}},
)
data = resp.json()
```

## Get the results

`run` is async and returns a `job_id`. Poll until `status` is `completed`, then read the rows:

```bash
# 1) check status
curl https://api.mindcase.co/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"

# 2) when status == completed, fetch the rows
curl https://api.mindcase.co/api/v1/jobs/JOB_ID/results \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"
```

Full API reference (auth, jobs, balance, SDKs, MCP): https://mindcase.co/skills.md

## Response columns

| Field | Display name | Type |
|-------|--------------|------|
| `eventName` | Event Name | text |
| `eventUrl` | Event URL | text |
| `description` | Description | text |
| `startDate` | Start Date | text |
| `dateTime` | Date Time | text |
| `duration` | Duration | text |
| `frequency` | Frequency | text |
| `isPast` | Is Past | 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 |