Facebook Events API

Facebook event data.
Find what’s happening around you.

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

PUT IT TO WORK

What will you build?

Three ways to use Facebook Events data.

Build a city event guide

Search by keyword with a city, a date range and a category to fill a local what’s-on list.

Research a specific event

Read event details and keep the original page linked in your notes.

YOUR FIRST REQUEST

Search Facebook events.

Search by keyword with a city, a date range and a category to fill a local what’s-on list.

  1. 01
    Add your API key

    Set SCRAPEATLAS_API_KEY in your environment.

  2. 02
    Choose your input

    Use the sample request as a starting point.

  3. 03
    Work with the JSON

    Send the result to your app, sheet or research tool.

Request and response fields
QUICKSTART / API EXAMPLES
# ScrapeAtlas · use your customer API key
export BASE_URL="https://api.scrapeatlas.com"

curl --get "$BASE_URL/v1/facebook/events/search" \
  -H "x-api-key: $SCRAPEATLAS_API_KEY" \
  --data-urlencode "query=jazz" \
  --data-urlencode "location_id=108424279189115" \
  --data-urlencode "date_from=2026-10-03" \
  --data-urlencode "date_to=2026-10-04" \
  --data-urlencode "category=music"
GET/v1/facebook/events/searchJSON response

Use your ScrapeAtlas API key. Replace the sample input with your own.

GETTING STARTED

A few practical details.

API key setup
How do I make a request?

Create a ScrapeAtlas API key, send it in the x-api-key header, and pass the endpoint’s request fields. The example above is ready to adapt to your own input.

What does the response contain?

Search events by keyword, city, dates and category, explore cities, follow page event listings and retrieve event details, including recurring events. Each endpoint’s reference shows its response fields and a JSON example.

Can I use this from an AI assistant?

Yes. Connect ScrapeAtlas through MCP to use Facebook Events tools from your assistant. You can also call the same API from your own scripts or the CLI.