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 lists a city's events, get_facebook_page 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
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:
{
"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
This page as Markdown: /docs/tools/search_facebook_events.md. Something wrong or missing: hello@parel.si.