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

# 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`](https://parel.si/docs/tools/search_facebook_events.md) 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

```bash
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:

```json
{
  "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

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