Skip to content
scrapeatlas.Dashboard

Events & communities

Facebook Events API

Public Facebook page events, city discovery, event search and event details.

6 endpointsx-api-key

Search Facebook events and retrieve event listings, details and profile events, with pagination and coverage.

API availability: Available

Base URL · local workerhttp://localhost:3039Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/facebook/profile/events

List Facebook page events

Retrieve events published by a public Facebook page. include=details adds event description, location and attendance fields where exposed.

Reference
GET/v1/facebook/events

Explore Facebook events by city

Explore events for a city with an optional relative date window and continuation. include=details adds per-event reads.

Reference
GET/v1/facebook/events/search

Search Facebook events

Search public Facebook events by keyword, optionally narrowed to a city, a date range and a category, with source continuation.

Reference
GET/v1/facebook/event/details

Get a Facebook event

Retrieve a public event with schedule, venue, description, hosts, tickets and attendance fields where exposed. A recurring event resolves to its current occurrence.

Reference
GET/v1/facebook/profiles/events

List Facebook page events via /profiles

Retrieve events published by a public Facebook page. include=details adds event description, location and attendance fields where exposed.

Reference
GET/v1/facebook/events/details

Get a Facebook event via /events

Retrieve a public event with schedule, venue, description, hosts, tickets and attendance fields where exposed. A recurring event resolves to its current occurrence.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl "https://api.scrapeatlas.com/v1/facebook/profile/events?url=https%3A%2F%2Fwww.facebook.com%2Fsynthetic.page%2F" \
  -H "x-api-key: YOUR_API_KEY"

Coverage & limits

  • Independent stateless worker on port 3039. No database, Facebook account, persistent browser session, cache or media hosting. A residential proxy can be configured for public pages that gate direct connections.
  • Two concurrent requests, 60-second overall deadline, 400 upstream requests and 64 MiB decoded source bytes per request, shared by enrichment legs. Fresh browser contexts close after each retrieval.
  • At most 100 records per page, 500,000 traversed nodes and depth 100. Full reels accept at most 50 records across five pages. Auxiliary reads have shorter deadlines and preserve usable partial data.
  • Only fixed Facebook public pages, native read-only GraphQL documents, Facebook static scripts and explicitly discovered fbcdn caption URLs are fetched. Service credentials never enter the browser. Media files are not downloaded.
  • cache_max_age and hostMedia are not accepted. Opaque cursors are route-specific; pass back the cursor issued by the route you called.
  • Facebook source changes, regional restrictions and private resources produce explicit failures. Missing counts remain null, never fabricated zeroes.
Error codes
10
HTTPfailure.codeMeaning
200partialUsable data with explicit missing/failed auxiliary coverage.
400invalid_requestMalformed, duplicate, conflicting or unsupported parameters.
401unauthorizedMissing or invalid service API key.
403restricted_pageThe resource is private or restricted.
404not_foundUnknown route or missing resource.
429upstream_rate_limitedFacebook throttled retrieval.
502upstream_challenged upstream_error unsupported_pageSource challenge, failure or unsupported/mismatched structure.
502response_too_large payload_too_complex request_limit unsafe_redirectBounded retrieval or fixed-origin policy failed.
503busyAll Facebook worker slots are occupied.
504timeoutRequest deadline expired.