# Facebook Events

Best for: Public events in a city or on a Page, with attendance. Category: Vehicles and events.

One Facebook events listing page: each event with name, start time, venue, online or in person, going and interested counts and cover image. One event in full adds the end time, description, hosts and ticket link.

- Look up by: A facebook.com events listing URL (a city explore page or a Page’s events page), or an event id or link
- Coverage: Public events on Facebook, worldwide
- Cost: 2 credits a call; failed and empty calls are free
- Answers: Search, Details

## Endpoints

- `POST /v1/facebook/events`: Facebook events listing, 2 credits. https://scrapercompany.com/docs/reference/facebook-events
- `POST /v1/facebook/event`: Facebook event details, 2 credits. https://scrapercompany.com/docs/reference/facebook-event

## Example

Facebook events listing (`POST /v1/facebook/events`):

```bash
curl -X POST "https://api.scrapercompany.com/v1/facebook/events" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.facebook.com/events/explore/wichita-kansas/105674782800210/"
  }'
```

## Good to know

- Attendance is Facebook’s own rounded figure.
- An empty page and a missing event are free.

## Guides

- [Public events: Facebook](https://scrapercompany.com/docs/guides/vertical-engines#facebook-events)

- [All data sources](https://scrapercompany.com/docs/data-sources)