> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_facebook_events

# search_facebook_events

> Facebook events matching a name or description: title, date, place, organiser and link. ₹0.28 per page; a result that finds nothing is ₹0.

## What it does

Public Facebook events matching a search: data with each event's name, date and time, place, organiser, attendance counts where shown and link, plus a cursor for the next page.

Use it to find launches, meetups, markets and shows by name or theme; [`get_facebook_events`](https://parel.si/docs/tools/get_facebook_events.md) lists a city's events, [`get_facebook_page`](https://parel.si/docs/tools/get_facebook_page.md) the organiser's Page. Flat price per page; nothing matching is free. Three to eight seconds.

India: events in Indian cities appear by name; add the city to the query.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The event name or description to search for. |
| `cursor` | string | no | The cursor from the previous answer, for the next page. |

## What drives the cost

Flat per page; pass cursor for the next page. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per page (`cost_paise: 28`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (`hold_paise: 42`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_facebook_events"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_facebook_events"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_facebook_events","input":{"query":"flea market Mumbai"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "events": [
    {
      "id": "248454259146276",
      "name": "Aarey Lunch",
      "type": "Event",
      "url": "https://www.facebook.com/events/248454259146276/",
      "day_time_sentence": "Saturday, September 29, 2018 at 12:00 PM – 3:00 PM IST",
      "event_place": {
        "__typename": "Page",
        "name": "Aarey Forest",
        "contextual_name": "Aarey Forest",
        "__isNode": "Page",
        "id": "1852680231718975"
      },
      "ticketing_context_row": {
        "price_range_text": null
      },
      "is_online": false,
      "is_past": true,
      "event_url": "https://www.facebook.com/events/248454259146276/",
      "event_kind": "PUBLIC_TYPE",
      "start_timestamp": 1538202600,
      "cover_photo": {
        "eventImage": {
          "uri": "https://scontent-atl3-1.xx.fbcdn.net/v/t1.6435-9/41951320_10215414715253953_7444759378739068928_n.jpg"
        }
      },
      "social_context": {
        "text": "2 interested · 3 going",
        "interested_count": 2,
        "going_count": 3,
        "went_count": null
      }
    },
    {
      "id": "531203821049889",
      "name": "Balloony.in Celebrate Children's day at The Krazy Kids Karnival",
      "type": "Event",
      "url": "https://www.facebook.com/events/531203821049889/",
      "day_time_sentence": "Nov 17, 2019 at 11:00 AM – Nov 18, 2019 at 10:00 AM IST",
      "event_place": {
        "__typename": "Page",
        "name": "BKC Bandra MMRDA Ground",
        "contextual_name": "BKC Bandra MMRDA Ground",
        "__isNode": "Page",
        "id": "223453801124022"
      },
      "ticketing_context_row": {
        "price_range_text": null
      },
      "is_online": false,
      "is_past": true,
      "event_url": "https://www.facebook.com/events/531203821049889/",
      "event_kind": "PUBLIC_TYPE",
      "start_timestamp": 1573968600,
      "cover_photo": {
        "eventImage": {
          "uri": "https://scontent-sjc6-1.xx.fbcdn.net/v/t1.6435-9/75388079_2724798184252088_2399416658532761600_n.jpg"
        }
      },
      "social_context": {
        "text": "0 interested · 0 going",
        "interested_count": 0,
        "going_count": 0,
        "went_count": null
      }
    },
    {
      "id": "1446874542288225",
      "name": "Presentation by Amit Mahajan - One Design Architects",
      "type": "Event",
      "url": "https://www.facebook.com/events/1446874542288225/",
      "day_time_sentence": "Wednesday, July 15, 2015 at 7:30 AM IST",
      "event_place": null,
      "ticketing_context_row": {
        "price_range_text": null
      },
      "is_online": false,
      "is_past": true,
      "event_url": "https://www.facebook.com/events/1446874542288225/",
      "event_kind": "PUBLIC_TYPE",
      "start_timestamp": 1436925600,
      "cover_photo": null,
      "social_context": {
        "text": "0 interested · 3 going",
        "interested_count": 0,
        "going_count": 3,
        "went_count": null
      }
    }
  ],
  "cursor": null
}
```

## Notes

- Flat per page; pass cursor for the next page.
- Add the city to the query to narrow it.
- Pairs with get_facebook_events for a whole city.

## Siblings

- [`get_facebook_events`](https://parel.si/docs/tools/get_facebook_events.md)
- [`get_facebook_page`](https://parel.si/docs/tools/get_facebook_page.md)
