City Events

GET/v1/facebook/events1 credit

Returns the events Facebook lists for a city, 12 per page, optionally limited to today, this week or next week.

01Query parameters

Name	Type	Description
urlrequired	string	A city's Facebook events page, e.g. `https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547`.
timeoptional	string	Time window; all upcoming events when omitted.Accepted values:`todaythis_weeknext_week`
cursoroptional	string	The `cursor` from the previous page.

02Request

curl "https://api.scrapesocial.ai/v1/facebook/events?url=https%3A%2F%2Fwww.facebook.com%2Fevents%2Fexplore%2Fsaint-petersburg-florida%2F111326725552547" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/events?url=https%3A%2F%2Fwww.facebook.com%2Fevents%2Fexplore%2Fsaint-petersburg-florida%2F111326725552547

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "events": [
    {
      "id": "1009766568177406",
      "schema_context": null,
      "cover_photo": {
        "photo": {
          "accessibility_caption": "May be an image of text that says 'W 獨'",
          "image": {
            "uri": "https://scontent-fra5-1.xx.fbcdn.net/v/t39.30808-6/691737832_122221920272546827_3621567388430112740_n.jpg?stp=c0.45.1600.764a_dst-jpg_tt6&cstp=mx1600x764&ctp=s640x640&_nc_cat=110&ccb=1-7&_nc_sid=75d36f&_nc_ohc=NHA3XLCgpdwQ7kNvwHNmbBJ&_nc_oc=Adpu050ZX3rbVJ0UZ8pyQuqUEigzJLtKWFt8j2u69s6HbPJd-MQq-O7FcQKw3pV0mnjKpSqFQtbMcE446onJWgsV&_nc_zt=23&_nc_ht=scontent-fra5-1.xx&_nc_gid=8GxHUJQsw0MJOFDdhA_QIg&_nc…"
          },
          "id": "122221920266546827"
        }
      },
      "cover_video": null,
      "gif_cover_photo": null,
      "online_event_setup": null,
      "is_happening_now": false,
      "day_time_sentence": "Sat, Nov 7 at 3:00 PM EST",
      "name": " 90s Day Party: St. Petersburg, FL 💿",
      "is_online": false,
      "ticketing_context_row": {
        "price_range_text": null
      },
      "event_place": {
        "__typename": "FreeformPlace",
        "contextual_name": "2655 6th Ave S, St Petersburg, FL 33712-1653, United States",
        "__isNode": "FreeformPlace",
        "id": "122231702342546827"
      },
      "eventUrl": "https://www.facebook.com/events/1009766568177406/",
      "can_page_viewer_invite_as_user": false,
      "can_viewer_invite": false,
      "can_viewer_rsvp": false,
      "can_viewer_share": true,
      "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": 1794081600,
      "rsvp_button_renderer": {
        "__typename": "PublicRsvpStyleRenderer",
        "event": {
          "id": "1009766568177406",
          "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": "1009766568177406"
      },
      "live_virtual_event_info": null,
      "__typename": "Event",
      "social_context": {
        "text": "7.1K interested · 231 going",
        "ranges": [],
        "interested_count": 7100,
        "going_count": 231,
        "went_count": null
      }
    },
    {
      "id": "1022044393663233",
      "schema_context": "{\"\\u0040context\":\"http:\\/\\/schema.org\",\"\\u0040type\":\"Event\",\"startDate\":\"2026-10-29T19:00:00-0400\",\"eventAttendanceMode\":\"https:\\/\\/schema.org\\/OfflineEventAttendanceMode\",\"name\":\"The Dillinger Escape Plan: Final Calculating Infinity Shows\",\"url\":\"https:\\/\\/www.facebook.com\\/events\\/jannus-live\\/the-dillinger-escape-plan-final-calculating-infinity-shows\\/1022044393663233\\/\",\"location\":{\"\\u0040type…",
      "cover_photo": {
        "photo": {
          "accessibility_caption": "May be an image of text",
          "image": {
            "uri": "https://scontent-fra3-2.xx.fbcdn.net/v/t39.99422-6/724408774_2154188625430117_5579727081050259079_n.png?stp=c0.58.2048.977a_dst-jpg_tt6&cstp=mx2048x977&ctp=s640x640&_nc_cat=107&ccb=1-7&_nc_sid=75d36f&_nc_ohc=dMrn6RDj_oEQ7kNvwF0mnJD&_nc_oc=Adr4tp9ehPtmbtBEnyZqcOAaB8SwG6BYR1yWw-7QRcm5ryL4oul1pjrlO1Y2yMr0YeLTMgJigueLFnSNcgNkDZ_2&_nc_zt=14&_nc_ht=scontent-fra3-2.xx&_nc_gid=8GxHUJQsw0MJOFDdhA_QIg&_nc_s…"
          },
          "id": "1481871503981402"
        }
      },
      "cover_video": null,
      "gif_cover_photo": null,
      "online_event_setup": null,
      "is_happening_now": false,
      "day_time_sentence": "Thu, Oct 29 at 7:00 PM EDT",
      "name": "The Dillinger Escape Plan: Final Calculating Infinity Shows",
      "is_online": false,
      "ticketing_context_row": {
        "price_range_text": null
      },
      "event_place": {
        "__typename": "FreeformPlace",
        "contextual_name": "Jannus Live",
        "__isNode": "FreeformPlace",
        "id": "1528287719338817"
      },
      "eventUrl": "https://www.facebook.com/events/1022044393663233/",
      "can_page_viewer_invite_as_user": false,
      "can_viewer_invite": false,
      "can_viewer_rsvp": false,
      "can_viewer_share": true,
      "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": 1793314800,
      "rsvp_button_renderer": {
        "__typename": "PublicRsvpStyleRenderer",
        "event": {
          "id": "1022044393663233",
          "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": "1022044393663233"
      },
      "live_virtual_event_info": null,
      "__typename": "Event",
      "social_context": {
        "text": "265 interested · 36 going",
        "ranges": [],
        "interested_count": 265,
        "going_count": 36,
        "went_count": null
      }
    }
  ],
  "cursor": "eyJzdGFydF90aW1lIjoxNzkyOTQ4MDE5LCJlbmRfdGltZSI6MTgwMDcyNDAxOSwiYnJvd3NlX2N1cnNvciI6IkFicjRsWF9zZV9QdHpZdERXU0ZzUWdHcy11bHFjRzEtdzdud0ZXNUkyOXZoelM4TmRiN1h1V0hkaks0X3B1VWlzdVNFVzY0UUN5N0FSQmlyczJrVjAzRE54bEhoZVlqc3E0ZDczX1JsWjVPSHFKcmI5U2MwZ2NjaUZyTnUyeEJNaVA3NWhTMXh1TWJjZ1V6M3VpT3dyN0RkdTRnNW9vTURwTWZuNE9BZm9fTEM3a2F3NnVObTI0SXQwT01jYkQ3TUxoWFNjamZjWWtfWFRjd0lRTFJQLTBnTkVhakktSUpyU2ktMFlUUVduWW9L…"
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Pass the response's `cursor` back for the next page. A page with no events returns an empty list for 0 credits. A URL that is not a city's events page is rejected with a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.