Facebook Events Scraper

Search indexed public Facebook events, resolve an events URL, or inspect one public event without a Facebook login.

Socialv0.1.0~2 credits/runSource on GitHub

Workspace

Configure

Inputs stay here while results become exportable artifacts.

Start from an example

Results

Preview, inspect, copy, or export the complete output.

Your result will become an artifact

Run the tool to inspect structured rows, raw JSON, execution details, and downloadable JSON, CSV, and Markdown files.

modecounteventqueryeventssource_urlnext_cursor

Overview

Facebook Events Scraper combines transparent search-index discovery with direct public event-page metadata. It returns source URLs, stable event IDs, titles, visible descriptions, location, organizer, date labels, and event images when Facebook exposes them.

Last validated: Jul 15, 2026

Input

idstring

Numeric Facebook event id for details mode.

urlstring

Facebook events search/Page URL or individual event URL.

mode"search" | "events_url" | "details"required

Search by phrase, resolve an events URL, or inspect one event.

timestring

Optional time phrase retained for competitor-compatible inputs.

querystring

Event search phrase.

cursorstring

Google result offset from a previous response.

max_resultsintegerdefault: 10

Maximum events to return.

Output

modestringrequired

Resolved operation.

countintegerrequired

Number of event records.

eventobject

Resolved individual event.

event.idstring

Facebook event id.

event.urlstring

Canonical public event URL.

event.titlestring

Visible event title.

event.locationstring

Visible event location.

event.image_urlstring

Public event image URL.

event.organizerstring

Visible event organizer.

event.descriptionstring

Visible Open Graph description.

event.start_time_labelstring

Visible event date/time label.

querystring

Resolved event search phrase.

eventsobject[]required

Public Facebook event records.

source_urlstringrequired

Fetched source URL.

next_cursorstring

Next search offset.

Examples

brisbane-events

{
  "mode": "search",
  "query": "Brisbane technology 2026",
  "max_results": 5
}

events-url

{
  "url": "https://www.facebook.com/IICA/events",
  "mode": "events_url",
  "max_results": 5
}

event-details

{
  "id": "1050688114286614",
  "mode": "details"
}

Use cases

Local event discovery

Find public Facebook events by city, theme, venue, or date phrase.

Event verification

Resolve a known event URL or numeric ID to its current public title, description, and image.

Community monitoring

Track source-linked public event listings without storing Facebook credentials.

FAQ

Does this require Facebook login?

No. Search uses Google's public index and details use Facebook's public Open Graph metadata.

Is event search complete?

No. Search coverage depends on public indexing and is explicitly best-effort.

Can it read private events?

No. It only returns event data exposed on public Facebook and search-index surfaces.

Use it anywhere

MCP (Claude, ChatGPT, Codex)

# After connecting https://betterfetch.co/api/mcp, ask your AI to:
1. Call search_tools for "Facebook Events Scraper"
2. Call run_tool with:
   name: "facebook_events_scraper"
   input: {"mode":"search","query":"Brisbane technology 2026","max_results":5}

REST

curl -sS -X POST "https://betterfetch.co/api/tools/facebook_events_scraper/run" \
  -H "Authorization: Bearer bf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"input": {"mode":"search","query":"Brisbane technology 2026","max_results":5}}'

Run locally

git clone https://github.com/better-fetch/tools/tree/main/tools/facebook-events-scraper && cd facebook-events-scraper && npm i
BETTER_FETCH_API_KEY=bf_your_key_here npx bf-tool run --input '{"mode":"search","query":"Brisbane technology 2026","max_results":5}'