get_facebook_events
The public events Facebook lists for a city: title, date, place, organiser and link. ₹0.28 per page; a result that finds nothing is ₹0.
What it does
The events Facebook lists for a city, from the city's Events explore page url: data with each event's name, date and time, place, organiser and link, plus a cursor for the next page; time narrows to a window.
Use it to see what is on in a city this week, for pop-ups, markets and brand activations; search_facebook_events finds events by name. Flat price per page. Three to eight seconds.
India: Indian cities have Events pages (Mumbai, Bengaluru, Delhi).
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
url | string | yes | The city's Events page on Facebook: open facebook.com/events, pick the city, copy the address (…/events/explore/<city>/<id>). |
time | string | no | A time frame as Facebook names it; leave empty for all. |
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: "get_facebook_events" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_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":"get_facebook_events","input":{"url":"https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547"}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"events": [
{
"id": "1488319459545073",
"schema_context": null,
"cover_photo": {
"photo": {
"accessibility_caption": "May be an image of yoga and text",
"image": {
"uri": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-6/851258423_122281063136254232_4930228204562132484_n.jpg"
},
"id": "122281063130254232"
}
},
"cover_video": null,
"gif_cover_photo": null,
"online_event_setup": null,
"is_happening_now": false,
"day_time_sentence": "Sat, Nov 7 at 9:00 AM EST",
"name": "St. Pete Yoga Fest",
"is_online": false,
"ticketing_context_row": {
"price_range_text": null
},
"event_place": {
"__typename": "FreeformPlace",
"contextual_name": "The St. Pete Pier",
"__isNode": "FreeformPlace",
"id": "1758075102985009"
},
"eventUrl": "https://www.facebook.com/events/1488319459545073/",
"can_page_viewer_invite_as_user": false,
"can_viewer_invite": false,
"can_viewer_rsvp": false,
"can_viewer_share": false,
"event_kind": "PUBLIC_TYPE",
"if_viewer_can_duplicate_event": null,
"is_online_or_detected_online": false,
"is_past": false,
"is_viewer_host": false,
"start_timestamp": 1794060000,
"rsvp_button_renderer": {
"__typename": "PublicRsvpStyleRenderer",
"event": {
"id": "1488319459545073",
"connection_style": "INTERESTED",
"can_viewer_join": false,
"can_viewer_watch": false,
"can_viewer_unwatch": false,
"viewer_watch_status": "UNWATCHED",
"if_viewer_can_see_going_button": null,
"event_connection_data_privacy_scope": null,
"privacy_scope_for_toast": null,
"can_join_group_chat": false,
"created_for_group": null,
"chat": null
},
"__module_operation_EventCometUniversalRSVPButton_event": {
"__dr": "PublicEventCometRSVPButtonRenderer_rsvpStyleRenderer$normalization.graphql"
},
"__module_component_EventCometUniversalRSVPButton_event": {
"__dr": "PublicEventCometRSVPButtonRenderer.react"
}
},
"parent_if_exists_or_self": {
"online_event_setup": null,
"id": "1488319459545073"
},
"live_virtual_event_info": null,
"__typename": "Event",
"social_context": {
"text": "1.1K interested · 108 going",
"ranges": [],
"interested_count": 1100,
"going_count": 108,
"went_count": null
}
},
{
"id": "1527199785709133",
"schema_context": null,
"cover_photo": {
"photo": {
"accessibility_caption": "May be an image of text",
"image": {
"uri": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-6/712544192_1443146581187595_2421226817355766293_n.jpg"
},
"id": "1443146577854262"
}
},
"cover_video": null,
"gif_cover_photo": null,
"online_event_setup": null,
"is_happening_now": false,
"day_time_sentence": "Sat, Nov 28 - Nov 29",
"name": "Shopapalooza Festival Nov 28-29 -- Free admission",
"is_online": false,
"ticketing_context_row": {
"price_range_text": null
},
"event_place": {
"__typename": "FreeformPlace",
"contextual_name": "701 Bayshore Drive Northeast, Saint Petersburg, FL, United States, Florida 33701",
"__isNode": "FreeformPlace",
"id": "1567581025410816"
},
"eventUrl": "https://www.facebook.com/events/1527199785709133/",
"can_page_viewer_invite_as_user": false,
"can_viewer_invite": false,
"can_viewer_rsvp": false,
"can_viewer_share": false,
"event_kind": "PUBLIC_TYPE",
"if_viewer_can_duplicate_event": null,
"is_online_or_detected_online": false,
"is_past": false,
"is_viewer_host": false,
"start_timestamp": 1795878000,
"rsvp_button_renderer": {
"__typename": "PublicRsvpStyleRenderer",
"event": {
"id": "1527199785709133",
"connection_style": "INTERESTED",
"can_viewer_join": false,
"can_viewer_watch": false,
"can_viewer_unwatch": false,
"viewer_watch_status": "UNWATCHED",
"if_viewer_can_see_going_button": null,
"event_connection_data_privacy_scope": null,
"privacy_scope_for_toast": null,
"can_join_group_chat": false,
"created_for_group": null,
"chat": null
},
"__module_operation_EventCometUniversalRSVPButton_event": {
"__dr": "PublicEventCometRSVPButtonRenderer_rsvpStyleRenderer$normalization.graphql"
},
"__module_component_EventCometUniversalRSVPButton_event": {
"__dr": "PublicEventCometRSVPButtonRenderer.react"
}
},
"parent_if_exists_or_self": {
"online_event_setup": null,
"id": "1527199785709133"
},
"live_virtual_event_info": null,
"__typename": "Event",
"social_context": {
"text": "8.2K interested · 622 going",
"ranges": [],
"interested_count": 8200,
"going_count": 622,
"went_count": null
}
},
{
"id": "4343576399286096",
"schema_context": null,
"cover_photo": {
"photo": {
"accessibility_caption": "May be a graphic of text",
"image": {
"uri": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-6/840664166_1735242908224981_3134762665198967697_n.jpg"
},
"id": "1735242898224982"
}
},
"cover_video": null,
"gif_cover_photo": null,
"online_event_setup": null,
"is_happening_now": false,
"day_time_sentence": "Thu, Nov 5 at 7:00 PM EST",
"name": "FloridaRAMA Impact Gallery Opening: Untitled, Curated by Chad Mize",
"is_online": false,
"ticketing_context_row": {
"price_range_text": null
},
"event_place": {
"__typename": "FreeformPlace",
"contextual_name": "2606 Fairfield Ave S, Saint Petersburg, FL, United States, Florida 33712",
"__isNode": "FreeformPlace",
"id": "1837289760648114"
},
"eventUrl": "https://www.facebook.com/events/4343576399286096/",
"can_page_viewer_invite_as_user": false,
"can_viewer_invite": false,
"can_viewer_rsvp": false,
"can_viewer_share": false,
"event_kind": "PUBLIC_TYPE",
"if_viewer_can_duplicate_event": null,
"is_online_or_detected_online": false,
"is_past": false,
"is_viewer_host": false,
"start_timestamp": 1793923200,
"rsvp_button_renderer": {
"__typename": "PublicRsvpStyleRenderer",
"event": {
"id": "4343576399286096",
"connection_style": "INTERESTED",
"can_viewer_join": false,
"can_viewer_watch": false,
"can_viewer_unwatch": false,
"viewer_watch_status": "UNWATCHED",
"if_viewer_can_see_going_button": null,
"event_connection_data_privacy_scope": null,
"privacy_scope_for_toast": null,
"can_join_group_chat": false,
"created_for_group": null,
"chat": null
},
"__module_operation_EventCometUniversalRSVPButton_event": {
"__dr": "PublicEventCometRSVPButtonRenderer_rsvpStyleRenderer$normalization.graphql"
},
"__module_component_EventCometUniversalRSVPButton_event": {
"__dr": "PublicEventCometRSVPButtonRenderer.react"
}
},
"parent_if_exists_or_self": {
"online_event_setup": null,
"id": "4343576399286096"
},
"live_virtual_event_info": null,
"__typename": "Event",
"social_context": {
"text": "197 interested · 24 going",
"ranges": [],
"interested_count": 197,
"going_count": 24,
"went_count": null
}
}
],
"cursor": "eyJzdGFydF90aW1lIjoxNzkzODkxODc5LCJlbmRfdGltZSI6MTgwMTY2Nzg3OSwiYnJvd3NlX2N1cnNvciI6IkFicnd2ZFRPbmQydjR2ak1kTUpfYjhqWUU3ZGkzeWtNenZBUVJfbzZvVm4waUV6bnVPRlBMakNuUVpNemJTTXQ5RGRHakkyXzYzLTY3WktSQ1k0T1k0aTRLSlNmdnFaZG1GRmV2UWVUMVpLcGNMQlI3dHFh…"
}
Notes
- Flat per page; pass cursor for the next page.
- The url is the city's Events explore page on Facebook.
- Pairs with search_facebook_events.
Siblings
This page as Markdown: /docs/tools/get_facebook_events.md. Something wrong or missing: hello@parel.si.