Facebook Event Details
Facebook Event Details is a direct lookup endpoint for event URLs you already know. Submit one or more public Facebook URLs containing /events/ to collect an event ID, canonical URL, name, description, start and end times, location, public media, visible metrics, and collection context when those fields are available.
Features
- Direct event URL lookupResolve known public Facebook event URLs without running a keyword, category, city, or date search.
- Normalized event metadataReturn a stable event shape with identity, canonical URL, name, description, and collection timestamp fields.
- Schedule and location contextCapture normalized start and end times plus the public location value when the source exposes them.
- Media and visible metricsInclude normalized public media and common engagement or response metrics when available for the event.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required array of public Facebook event URLs. Accepted hosts are facebook.com, www.facebook.com, and m.facebook.com, and each path must contain /events/. |
How to Use
Submit event URLs as an asynchronous task, poll its task ID, then read the normalized event records.
- Prepare one or more public facebook.com, www.facebook.com, or m.facebook.com URLs whose path contains /events/.
- POST urls to /v1/facebook/event-details.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read data.results.items from /v1/tasks/{task_id}?limit=50 and follow results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/facebook/event-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/events/123456789012345/"]}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.Best Use Cases
- Event metadata enrichment: Enrich a stored event URL with normalized identity, name, description, location, timing, media, and visible metrics.
- Calendar ingestion: Map available event names, start and end times, descriptions, locations, and source URLs into a calendar pipeline.
- Organizer and venue research: Review the public description, location, schedule, media, and response signals for an existing list of event URLs.
- Known-event refreshes: Re-run saved event URLs to refresh the public fields currently available from the source.
Pro Tips
- Use the canonical event-detail URL rather than a Page event list or another Facebook URL that merely includes an events segment.
- Treat name, description, location, schedule, media, and metrics as optional because source visibility varies by event.
- Keep extra.input_url when reconciling results with a multi-URL request; one submitted URL can produce at most one event record.
- Private, deleted, restricted, or login-only events may complete without a returned event record.
Related APIs
Use these APIs when you need a different type of public Facebook data.
- Facebook Pages API — Retrieve public Page profiles, contact details, images, and visible audience ratings.
- Facebook Posts API — Collect public posts, media, reactions, comments, and shares from supported Facebook URLs.
- Facebook Comments API — Collect public comments, authors, engagement, media, and source links from post URLs.
- Facebook Video Transcript API — Extract available transcript text and format from known public video post or Reel URLs.
- Facebook Group Posts API — Collect public posts from Facebook group URLs with selectable ordering, per-group limits, author context, video media, and visible engagement.
- Facebook Events Search API — Search public events by keyword with schedule, place, attendance, cover media, and event-state fields.
- Facebook Ad Transcript API — Extract available spoken-word text, language, format, and source context from Facebook Ad Library URLs.
- Facebook Comment Replies API — Retrieve public replies for a known comment using its feedback ID and expansion token, with text, author identity, engagement, and parent context.
- Facebook Company Reviews API — Collect public Page reviews with review text, reviewer links, ratings, likes, timestamps, and company context.
- Facebook Profile Events API — Collect public events associated with profile or Page URLs, including names, schedules, locations, media, visible metrics, and source context.
- Facebook Profile Photos API — Collect public photos from profile or Page URLs with captions, author context, engagement, image metadata, and source references.
- Facebook Profiles API — Look up public profiles or Pages from known Facebook URLs with identity, bio, avatar, visible counters, and input context.
- Facebook Reels API — Collect public Reels from profile or Page URLs with captions, author context, video metadata, visible engagement, and source references.
Combine Facebook data with public data from other supported social platforms.