# Facebook Event Details API (https://www.socialcrawl.dev/platforms/facebook/event-details)

> Fetches full metadata for a Facebook event. The canonical Post leaves carry the title (`content.text`), the cover image (`content.thumbnail_url`), the permalink and the host line; the event record itself rides `post.ext.event`: `description`, `start_timestamp` and `end_timestamp`, the rendered `time_text` ("Saturday, August 29, 2026 at 7:00 PM - 9:00 PM PDT", the only place the event's own timezone appears), `duration_text`, `location_name`, `address`, `city`, `latitude` and `longitude`, `hosts[]` (each with id, name, url and a verification flag), `category`, `ticket_url`, `privacy`, `is_online`, `is_canceled`, `is_past`, and the RSVP counts `interested_count`, `going_count` and `attendance_count`. **Read the RSVP counts from `post.ext.event`, not from `post.engagement`:** an event has no views or likes, so `engagement.views` carries the interested count and `engagement.likes` the going count for archetype compatibility, and `computed.engagement_rate` is derived from those RSVPs rather than from any real engagement.

TL;DR: `GET /v1/facebook/event/details` 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 |
| --- | --- | --- |
| `id` | no | Facebook event ID (numeric). |
| `url` | no | Full URL of the event. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/facebook/event/details" \
  --data-urlencode "url=https://www.facebook.com/events/4271394179613905/" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the Facebook event API?

GET /v1/facebook/event/details returns the full details for one Facebook event. Anchor the call with the event id or its url and you get the date, venue, description, ticket info, and going count as JSON. It costs 1 credit.

### Do I pass an id or a url?

Either one. The endpoint accepts id or url and you supply exactly one. Pass id if you captured it from an events list or search; pass url if you only have the event's shared link.

### What fields come back for an event?

You get the event name, description, start and end date, venue and location, host, cover image, ticket or registration info, and attendance counts like interested and going. Fields follow the shared SocialCrawl schema.

### How does this pair with the events list?

Reach for it when you already have one event id in hand, or when you came from /v1/facebook/events/search. If you are working through a listing, /v1/facebook/events and /v1/facebook/profile/events both take include=details and fill the deep fields on every row in the same call, so there is no need for a lookup per event.

### How much does it cost?

Each event detail lookup is 1 credit on the standard tier. New accounts get 100 free credits with no card, so you can inspect the full response shape before you build.

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 full details of a Facebook event with an API?
- How do I fetch a Facebook event's date, venue, and attendance by id or url?