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.

FieldTypeRequiredDescription
querystringyesThe event name or description to search for.
cursorstringnoThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_facebook_events"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_facebook_events"
Confirmationnot 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.