Search Events

GET/v1/facebook/events/search1 credit

Searches Facebook events by keyword and returns the name, place, date and cover photo of each event, and whether it is online or already past.

01Query parameters

Name	Type	Description
queryrequired	string	The search keyword.
cursoroptional	string	The page number from the previous answer's `cursor`, 2 to 10.

02Request

curl "https://api.scrapesocial.ai/v1/facebook/events/search?query=jazz" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/facebook/events/search?query=jazz

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "events": [
    {
      "id": "2927489020964933",
      "name": "Anne Wolf Trio invites Chrystel Wautier",
      "type": "Event",
      "url": "https://www.facebook.com/events/2927489020964933/",
      "day_time_sentence": "Wednesday, October 28, 2026 at 8:30 PM CET",
      "event_place": {
        "__typename": "Page",
        "name": "The Music Village - Jazz Club",
        "contextual_name": "The Music Village - Jazz Club",
        "__isNode": "Page",
        "id": "298880620228415"
      },
      "ticketing_context_row": {
        "price_range_text": null
      },
      "is_online": false,
      "is_past": false,
      "event_url": "https://www.facebook.com/events/2927489020964933/",
      "event_kind": "PUBLIC_TYPE",
      "start_timestamp": 1793215800,
      "cover_photo": {
        "eventImage": {
          "uri": "https://scontent.fada2-2.fna.fbcdn.net/v/t39.99422-6/854338684_957554936939990_680834450825688367_n.png?stp=dst-jpg_tt6&cstp=mx1400x657&ctp=s1400x657&_nc_cat=100&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=75d36f&_nc_ohc=p-V7o1KgtAcQ7kNvwEGP0lS&_nc_oc=AdowjPS9Os37c1oufVAzW38C_mw61G4RVp9tYur011hDxAhTTiSPK4-LyfprpHEXk8TdAMEFE-fTRar53p6hrsB5&_nc_zt=14&_nc_ht=scontent.fada2-2.fna&_nc_gid=8upZWM2Ak21Cu0x…"
        }
      },
      "social_context": {
        "text": "4 interested · 2 going",
        "interested_count": 4,
        "going_count": 2,
        "went_count": null
      }
    },
    {
      "id": "1575216017685079",
      "name": "Cairo Jazz Festival 2026",
      "type": "Event",
      "url": "https://www.facebook.com/events/1575216017685079/",
      "day_time_sentence": "Nov 5 at 4:00 PM – Nov 7 at 11:00 PM EET",
      "event_place": {
        "__typename": "FreeformPlace",
        "name": "Cairo, Egypt",
        "contextual_name": "Cairo, Egypt",
        "__isNode": "FreeformPlace",
        "id": "1671857711166281"
      },
      "ticketing_context_row": {
        "price_range_text": null
      },
      "is_online": false,
      "is_past": false,
      "event_url": "https://www.facebook.com/events/1575216017685079/",
      "event_kind": "PUBLIC_TYPE",
      "start_timestamp": 1793887200,
      "cover_photo": {
        "eventImage": {
          "uri": "https://scontent.fada2-2.fna.fbcdn.net/v/t39.30808-6/829519082_1671857907832928_1092147868111775435_n.jpg?stp=dst-jpg_tt6&cstp=mx1600x750&ctp=s1600x750&_nc_cat=106&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=75d36f&_nc_ohc=2m9e4cXkgxQQ7kNvwGMJcxR&_nc_oc=Adp-RhI45-B4MWHexFBg4AH35Lg8WsfLXA_lPSQI7irYdRe09p9tRZhaCZxtuS3HhnV6HyQJTWOyfdBqQwZK_WLT&_nc_zt=23&_nc_ht=scontent.fada2-2.fna&_nc_gid=5YczL8TtG3kp4…"
        }
      },
      "social_context": {
        "text": "111 interested · 31 going",
        "interested_count": 111,
        "going_count": 31,
        "went_count": null
      }
    }
  ],
  "cursor": "2"
}

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

`cursor` is a page number; pass it back for the next page, up to page 10. A search with no events returns an empty list for 0 credits.

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.