social data api

Facebook Events

Event search, event listings and event details.

Find events	`/v1/facebook/events/search`	1 request
Events in a city	`/v1/facebook/events`	1 request
Event details	`/v1/facebook/event/details`	1 request

GET/v1/facebook/events/search

Find events

1 request

Finds Facebook events whose name matches a query. The data matches what Facebook shows on its event search page, for example this search.

Query parameters

`query` stringrequired	Text to search event names for.
`cursor` string	Cursor from the previous response, used to load the next page.

curl "https://api.pandorlabs.com/v1/facebook/events/search?query=Event+name+or+description" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "events": [
    {
      "id": "24659081027102562",
      "name": "DockDogs® at Frankenmuth Dog Bowl",
      "type": "Event",
      "url": "https://www.facebook.com/events/24659081027102562/",
      "day_time_sentence": "Fri, May 22 - May 24",
      "event_place": {
        "__typename": "FreeformPlace",
        "contextual_name": "Frankenmuth River Place Shops",
        "__isNode": "FreeformPlace",
        "id": "1455187729296539"
      },
      "ticketing_context_row": {
        "price_range_text": null
      },
      "is_online": false,
      "is_past": false,
      "event_url": "https://www.facebook.com/events/24659081027102562/",
      "event_kind": "PUBLIC_TYPE",
      "start_timestamp": 1779480000,
      "cover_photo": {
        "accessibility_caption": "No photo description available.",
        "eventImage": {
          "uri": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-6/593531570_1415564506592195_6877452715877012878_n.jpg?stp=dst-jpg_p75x225_tt6&_nc_cat=108&ccb=1-7&_nc_sid=7e0d18&_nc_ohc=lfZDvDmA5TgQ7kNvwGAJ9kC&_nc_oc=AdpiWd2PvIAUMK-DqCWA4v5iUaC2q5pKzs1BCj…"
        },
        "id": "1415564503258862"
      },
      "social_context": {
        "text": "21 interested · 10 going",
        "interested_count": 21,
        "going_count": 10,
        "went_count": null
      }
    }
  ],
  "cursor": "Abr1gHMU6H...."
}

GET/v1/facebook/events

Events in a city

1 request

Lists events in a city from its Facebook Events page, such as this one for Saint Petersburg, Florida.

Query parameters

`url` stringrequired	Link to the city's Facebook Events page.
`time` string	Restrict to today, this week, or next week; no time limit when omitted. `todaythis_weeknext_week`
`cursor` string	Cursor from the previous response, used to load the next page.

curl "https://api.pandorlabs.com/v1/facebook/events?url=https%3A%2F%2Fwww.facebook.com%2Fevents%2Fexplore%2Fsaint-petersburg-florida%2F111326725552547" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "events": [
    {
      "id": "2255360061870188",
      "schema_context": null,
      "cover_photo": {
        "photo": {
          "accessibility_caption": "May be an image of crowd",
          "image": {
            "uri": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-6/651106377_950305721046361_5055393414866459656_n.jpg?stp=c0.128.2048.977a_dst-jpg_s640x640_tt6&_nc_cat=102&ccb=1-7&_nc_sid=7e0d18&_nc_ohc=uoUS18WdA8AQ7kNvwFst0pe&_nc_oc=AdrKSULesf0R7do30SFyq…"
          },
          "id": "950305717713028"
        }
      },
      "cover_video": null,
      "gif_cover_photo": null,
      "online_event_setup": null,
      "is_happening_now": false,
      "day_time_sentence": "Sun, May 3 at 12:00 PM EDT",
      "name": "May St. Pete Flea ",
      "is_online": false,
      "ticketing_context_row": {
        "price_range_text": null
      },
      "event_place": {
        "__typename": "Page",
        "contextual_name": "Mirror Lake Park, Downtown St Pete",
        "__isNode": "Page",
        "id": "521768081246129"
      },
      "eventUrl": "https://www.facebook.com/events/2255360061870188/",
      "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": 1777824000,
      "rsvp_button_renderer": {
        "__typename": "PublicRsvpStyleRenderer",
        "event": {
          "id": "2255360061870188",
          "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": "2255360061870188"
      },
      "live_virtual_event_info": null,
      "__typename": "Event",
      "social_context": {
        "text": "7.3K interested · 195 going",
        "ranges": [],
        "interested_count": 7300,
        "going_count": 195,
        "went_count": null
      }
    }
  ],
  "cursor": "eyJzdGFydF...."
}

GET/v1/facebook/event/details

Event details

1 request

Returns one Facebook event, identified by its id or URL.

Query parameters

`id` string	Event ID.
`url` string	Link to the event.

curl "https://api.pandorlabs.com/v1/facebook/event/details" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "id": "2255360061870188",
  "url": "https://www.facebook.com/events/2255360061870188/",
  "name": "May St. Pete Flea ",
  "description": "SPRING IS HERE AND WE CAN’T WAIT TO SEE YOU AT THE MARKET! \nMeet us downtown at Mirror Lalke as we host some of the best makers, artists and small businesses in the Tampa Bay area. \n\nWe have three great dates this spring to shop with us as …",
  "category": null,
  "categories": [],
  "is_online": false,
  "is_past": true,
  "event_kind": "PUBLIC_TYPE",
  "privacy": "public",
  "start_time": null,
  "end_time": null,
  "time_text": null,
  "duration": "4 hr",
  "price": null,
  "ticket_url": null,
  "ticket_source": null,
  "ticket_provider": null,
  "location_name": "Mirror Lake Park, Downtown St Pete",
  "address": "Saint Petersburg, FL",
  "city": "Saint Petersburg, Florida",
  "city_id": "111326725552547",
  "latitude": 27.776053761243,
  "longitude": -82.639546684316,
  "attendance_count": 7654,
  "attendance_facepile_count": 0,
  "can_view_members": true,
  "host_context_text": "Event by The Indie Flea",
  "hosts": [
    {
      "id": "100082008263628",
      "name": "The Indie Flea",
      "type": "User",
      "url": "https://www.facebook.com/theindieflea",
      "is_verified": false,
      "profile_picture_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.30808-1/464183650_549071584503112_3055385531133902634_n.jpg?stp=cp0_dst-jpg_s74x74_tt6&_nc_cat=104&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=5rQ_jTw3GmkQ7kNvwG062e2&_nc_oc=Adr0ZXLJg--_9LY1GPBvQABFqOzL6wTn_aMO…"
    }
  ],
  "host_names": [
    "The Indie Flea"
  ],
  "creator": {
    "id": "100082008263628",
    "name": "The Indie Flea",
    "type": "User",
    "url": null,
    "is_verified": null,
    "profile_picture_url": null
  },
  "description_links": [],
  "can_viewer_message": false,
  "is_viewer_host": false,
  "is_canceled": false,
  "cover_photo_url": "https://scontent.fbra1-1.fna.fbcdn.net/v/t39.30808-6/651106377_950305721046361_5055393414866459656_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=7e0d18&_nc_ohc=uoUS18WdA8AQ7kNvwFUcvhb&_nc_oc=AdqWorZuBJd3sf4yoI3PeFWcGVbKk8NCCM5lLn8K1d2x_sWSVx3EPXl8AEd0D…",
  "day_time_sentence": "Sunday, May 3, 2026 at 12:00 PM – 4:00 PM EDT"
}