Facebook Profile Events
Facebook Profile Events are public event listings associated with a profile or Page, with names, descriptions, locations, start and end times, media, and visible metrics. Their schedule and source context support organizer calendar enrichment, event inventory research, and cross-Page comparison.
Features
- Profile and Page event feedsCollect public event listings associated with one or more submitted Facebook profile or Page URLs.
- Event identity and scheduleReturn event IDs, public URLs, names, descriptions, locations, normalized start times, and end times.
- Media and visible metricsPreserve normalized public image or video references and common visible metrics supplied with each event.
- Normalized source contextAttach the submitted source URL to each normalized record while removing duplicate events by ID or URL within that source feed.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | One or more Facebook profile or Page URLs on facebook.com, www.facebook.com, or m.facebook.com. |
results_limit | Optional | Maximum event records to collect per input URL, from 20 to 2,000; defaults to 100. |
How to Use
Submit profile or Page URLs as an asynchronous task, poll its task ID, then read normalized event records with cursor pagination.
- Prepare one or more Facebook profile or Page URLs and choose an optional results_limit from 20 to 2,000 for each URL.
- POST urls and an optional results_limit to /v1/facebook/profile-events.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read /v1/tasks/{task_id}?limit=50 and continue with results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/facebook/profile-events" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Best Use Cases
- Organizer calendar enrichment: Use event names, descriptions, locations, and start and end times to enrich calendars built from known public organizer Pages.
- Cross-Page event inventory: Group normalized event IDs and URLs by input_url to compare public event listings across selected profiles or Pages.
- Event detail collection queues: Use returned event URLs to build a deduplicated queue for deeper event detail retrieval.
- Public schedule reporting: Combine schedule fields, media references, and visible metrics into reports about events associated with tracked public sources.
Pro Tips
- Submit profile or Page targets that expose an event feed; host validation alone does not confirm that a Facebook URL represents a suitable source.
- Choose results_limit with the number of input URLs in mind because the limit and estimated result-based cost apply separately to each URL.
- When the same event may be associated with multiple submitted sources, deduplicate merged results by event ID or public URL.
- Treat description text, location, end time, media, and individual metric values as optional when mapping records into your application.
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 Event Details API — Collect normalized metadata, schedules, locations, media, and visible engagement from known public event URLs.
- 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.