# Facebook Events API (https://www.socialcrawl.dev/platforms/facebook/events)

> Returns the events listed under a Facebook city/region Events explore page. Filter by relative `time` (defaults to all time) and forward the returned cursor for additional pages.

TL;DR: `GET /v1/facebook/events` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the city's Facebook Events page. |
| `time` | no | Relative time window. Defaults to all time when omitted. (today \| this_week \| next_week) |
| `cursor` | no | Cursor returned by the previous response for pagination. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/facebook/events?url=https%3A%2F%2Fwww.facebook.com%2Fevents%2Fexplore%2Fsaint-petersburg-florida%2F111326725552547" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the Facebook Events API?

GET /v1/facebook/events lists Facebook events for a city. Pass the city events page url and the response returns each event with its name, date, venue, and cover image. It costs 1 credit per call.

### What URL do I pass?

Pass the Facebook city events page URL in the url param, for example the /events/ page for a given city. The endpoint reads that page and returns the structured event list, so you do not have to parse the HTML yourself.

### How do I page through more events?

Take the cursor value from the response and pass it as the cursor param on the next call to load the next page of events. Repeat until the cursor comes back empty.

### Can I filter by date or time?

Yes. Use the optional time param to narrow the events window. Combine it with cursor pagination to build a rolling feed of upcoming local events for an event discovery pipeline.

### How is this better than the Graph API?

It returns city event listings as clean JSON behind one x-api-key, without app review, tokens, or Graph API scopes. Each call is 1 credit, and new accounts get 100 free credits with no card.

See the full Facebook API: https://www.socialcrawl.dev/platforms/facebook

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get a list of Facebook events for a city with an API?
- Is there an API for local event discovery on Facebook?