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.

FieldTypeRequiredDescription
urlstringyesThe city's Events page on Facebook: open facebook.com/events, pick the city, copy the address (…/events/explore/<city>/<id>).
timestringnoA time frame as Facebook names it; leave empty for all.
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: "get_facebook_events"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_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":"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.