Skip to content
Docs

Facebook Events

Public events in a city or on a Page, with attendance.One Facebook events listing page: each event with name, start time, venue, online or in person, going and interested counts and cover image. One event in full adds the end time, description, hosts and ticket link.
Look up by
A facebook.com events listing URL (a city explore page or a Page’s events page), or an event id or link
Coverage
Public events on Facebook, worldwide
Cost
2 credits a call; failed and empty calls are free
Endpoints
2 endpoints
  • Search
  • Details

Endpoints

Example

Facebook events listing, with POST /v1/facebook/events. Set SCRAPERCOMPANY_API_KEY to your key and run it; the full parameter list is in the API reference.

curl -X POST "https://api.scrapercompany.com/v1/facebook/events" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.facebook.com/events/explore/wichita-kansas/105674782800210/"
  }'
200 response
{
  "search_parameters": {
    "engine": "facebook_events",
    "source_url": "https://www.facebook.com/events/explore/wichita-kansas/105674782800210/"
  },
  "events_results": [
    {
      "event_id": "1787320825754872",
      "name": "MadHop Music Festival 2026",
      "url": "https://www.facebook.com/events/1787320825754872/",
      "start_time": "2026-11-06T23:00:00+00:00",
      "start_timestamp": 1794006000,
      "day_time_sentence": "Fri, Nov 6 - Nov 7",
      "place_name": "Historic Downtown Madison, Indiana",
      "is_online": false,
      "is_past": false,
      "going_count": 96,
      "interested_count": 277,
      "social_context": "277 interested · 96 going",
      "cover_image": "https://scontent.fykz2-1.fna.fbcdn.net/v/t39.30808-6/753237232_1541150707815153_6520244248732023965_n.png",
      "event_kind": "PUBLIC_TYPE"
    }
  ],
  "total": 1,
  "has_next_page": true,
  "next_cursor": "eyJzdGFydF90aW1lIjoxNzkzODUzNzc0LCJlbmRfdGltZSI6",
  "meta": {
    "source": "facebook",
    "elapsed_s": 1.18
  }
}

Try it on your key

Good to know

  • Attendance is Facebook’s own rounded figure.
  • An empty page and a missing event are free.

Guides

Cars for sale in the US and Europe, upcoming events with resale ticket prices, and public Facebook events.

Or browse every data source.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support