---
title: "Facebook Event Details API"
method: GET
path: "/v1/facebook/event-details"
tags: ["Facebook Events"]
---

# Facebook Event Details API

`GET /v1/facebook/event-details`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/facebook/event-details`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get a Facebook event — title, local start/end, timezone, place, host id, and attendance when exposed.

Paste a Facebook event URL and get clean JSON using the shared Event shape: title, description, startDate/endDate as ISO with the host timezone offset (calendar day matches startTime), IANA timezone resolved from venue coordinates when present (else the display-sentence abbreviation — GMT→Europe/London; never Etc/*; null when unknown), duration, eventType (discovery category) + visibility (public|private|…), location{name,city,latitude,longitude,countryCode} (fixed key set — null when unknown), organizers[{id,name,url,verified}], categories, ticketsUrl, and going/interested counts when Facebook exposes them on the logged-out hydrate. An event Facebook does not show logged-out is 404 at 0 credits. Flat 2 credits per call.

Docs: https://captapi.com/apis/facebook-event-details

## Query parameters

- `url` string, required
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `platform` string: Platform identifier for this response (matches the endpoint's platform).
    - `id` string: Stable platform ID for the item.
    - `url` string: Canonical URL of the item.
    - `name` string: Name of the item or account. On profile endpoints: deprecated alias of displayName (one release).
    - `description` string: Description text.
    - `startDate` string, nullable: Event start as ISO-8601 with the host timezone offset (e.g. 2026-08-19T19:00:00-05:00). Calendar day matches startTime — not UTC midnight.
    - `endDate` string, nullable: Event end as ISO-8601 with the same host timezone offset when Facebook exposes end_timestamp.
    - `timezone` string, nullable: IANA timezone inferred from the startTime abbreviation (e.g. America/Chicago for CDT).
    - `startTime` string: Facebook's human-readable local schedule sentence (includes TZ abbrev).
    - `duration` string, nullable: Human duration from Facebook (e.g. 1 hr 30 min) or derived from start/end.
    - `durationSeconds` integer, nullable: Duration in seconds when start and end timestamps are known.
    - `eventType` string, nullable: Discovery category label when present (e.g. Comedy). Never a Facebook visibility constant — see visibility.
    - `visibility` string: Lowercase audience enum derived from Facebook's *_TYPE (public|private|friends|group|community). Null when unknown.
    - `isOnline` boolean: Is online. Example: false.
    - `isPast` boolean: Whether the event start is in the past (Relay is_past, else derived from startDate vs now).
    - `isCanceled` boolean: Is canceled. Example: false.
    - `address` string, nullable: Street / one-line address when distinct from location.name. Null when it would only echo city.
    - `image` string: Image URL.
    - `usersGoing` unknown
    - `usersInterested` unknown
    - `usersResponded` unknown
    - `location` object
      - `name` string, nullable: Name of this location item.
      - `city` string: City. Example: "Rosemont, IL".
      - `state` unknown
      - `latitude` number: Latitude. Example: 41.97826.
      - `longitude` number: Longitude. Example: -87.86738.
      - `countryCode` string: ISO-3166 alpha-2 country code (e.g. US, MX).
    - `organizers` object[]
      - `id` string: Id of this organizers item.
      - `name` string: Name of this organizers item.
      - `url` string: Canonical URL of the item.
      - `verified` boolean: Whether the host Page/profile shows a verified badge (on organizers[].verified).
    - `ticketsUrl` unknown
    - `categories` object[]
      - `label` string: Label. Example: "कॉमेडी".
      - `url` string: Canonical URL of the item.
    - `externalLinks` unknown[]: Outbound links attached to the event when Facebook exposes them (often empty).
      - unknown

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

## Changes

- **2026-10-19** `c9b9ac5ff1bd`: 9 breaking, 6 info
  - the response property `data/address` became nullable for the status `200`
  - the response property `data/duration` became nullable for the status `200`
  - the response property `data/durationSeconds` became nullable for the status `200`
  - the response property `data/endDate` became nullable for the status `200`
  - …11 more

[Operation history](https://skmtc.dev/captapi/apis/captapi-api/changes/v1/facebook/event-details/get.md)

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)