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

> Returns upcoming and past events for a public Facebook page, including title, date/time, location, cover image, and attendee counts when exposed. Forward the returned cursor for additional pages.

TL;DR: `GET /v1/facebook/profile/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 public Facebook page. |
| `cursor` | no | Cursor returned by the previous response for pagination. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/facebook/profile/events?url=https%3A%2F%2Fwww.facebook.com%2Fbrickyardoldtown" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the Facebook page events API?

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

### What do I pass to identify the page?

Pass the page's Facebook URL in the url param. The endpoint reads that page's events tab and returns the structured list, so you can track a venue, brand, or organizer's upcoming events without opening a browser.

### How do I page through the full event list?

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

### How is this different from the city events endpoint?

/v1/facebook/events lists events for a city, while profile/events lists the events for one specific page. Use this to monitor a single venue or organizer's calendar over time.

### How much does it cost?

Each call is 1 credit on the standard tier. New accounts start with 100 free credits and no card, so you can wire up a page's event calendar and test it before spending.

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 list a Facebook page's events with an API?
- How do I monitor a venue or organizer's Facebook events?