Facebook Events API

Facebook Events Scraper API for Event Search and Details

Search events by keyword, city, dates and category, explore cities, follow page event listings and retrieve event details, including recurring events.

WHAT YOU CAN BUILD / 04 ENDPOINTS

Put Facebook Events data to work.

Find your use case, then explore the request and response.

List Facebook page events

GET/v1/facebook/profile/events

Build an organizer calendar from the events published by a Facebook page, with links to event details.

Explore Facebook events by city

GET/v1/facebook/events

Build a city events guide by collecting Facebook events associated with a selected city.

Search Facebook events

GET/v1/facebook/events/search

Build an event discovery tool that finds Facebook events matching a search query.

Get a Facebook event

GET/v1/facebook/event/details

Build an event preview with its name, description, dates, location and organizer information.

HOW IT WORKS

From API key to Facebook Events data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 4 Facebook Events endpoints and add its input, such as a search query.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Facebook Events data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

TRY IT HERE / LIVE SAMPLE

Try a sample request.

Try the Facebook Events API right here. This sample uses the Search Facebook events endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with jazz, or change the query field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Search Facebook eventsNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "jazz";
const url = new URL("/website/demo/facebook-events",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/facebook/events/search

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Save 6.3%

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Facebook Events API

Frequently Asked Questions

Explore the API reference

Facebook Events API and scraping

What can I retrieve with the Facebook Events API?

Retrieve events published by a Facebook page, explore events by city, search events by keyword and read individual event details. Use the results to build an organizer calendar or a local event discovery tool.

How do I use a Facebook Events scraper for a page calendar?

Request Page Events for the organizer’s page. Select event-detail enrichment to add descriptions, locations and attendance fields. The individual Event endpoint provides schedules, venues, hosts and ticket information for a selected event.

Can I retrieve one Facebook Events listing from its URL?

Use Event Details to retrieve the selected event’s description, schedule, venue and host information. Keep the event URL with the record so your calendar entry links back to the original listing.

Facebook Events: event discovery and calendars

Can I search Facebook Events by city, date and category?

Yes. Event Search accepts keywords and can narrow results by city, date range and category. Explore Events provides city-based browsing with a relative date window. Use the continuation returned by the selected endpoint to request more results.

Can the Facebook Events API return hosts and ticket information?

Event Details provides host and ticket information together with the event schedule and venue. Your application can use those fields to add organizer context and the published ticket destination to an event preview.

Which Facebook Events fields can I use in an event directory?

Event Details returns the event description, schedule, venue, hosts, tickets and attendance information. Those fields let your application display a date, destination and organizer together with a link to the original event.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?