Facebook Events Search
Facebook Events are public event listings with names, schedule text, start times, places, attendance signals, cover images, and online or past-event status. These records support event discovery, schedule monitoring, venue research, and attendance comparison.
Features
- Keyword-based event discoveryUse a text query to find public Facebook event records associated with a topic, activity, organization, or place.
- Event identity and scheduleReturn event IDs, names, public URLs, schedule text, and normalized start times for matching records.
- Place and event-state contextPreserve place IDs, place names, online status, and past-event status to distinguish venue and timing context.
- Attendance and cover fieldsInclude visible interested, going, and went counts together with a public cover image reference when present.
Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | A non-empty keyword query used to search public Facebook events. |
results_limit | Optional | Maximum event records to collect, from 7 to 2,000; defaults to 100. |
How to Use
Submit a keyword as an asynchronous task, poll its task ID, then read normalized event records with cursor pagination.
- Prepare a non-empty keyword query and choose an optional results_limit from 7 to 2,000.
- POST query and results_limit to /v1/facebook/events-search.
- 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/events-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"technology conference","results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Best Use Cases
- Topic-based event discovery: Use a focused query with event names, public URLs, and schedule text to assemble a list of relevant public events.
- Schedule monitoring: Compare normalized start times, schedule text, event IDs, and past-event status across collection runs.
- Venue and format research: Organize matching events by place ID, place name, and online status to study where and how events are listed.
- Visible attendance comparison: Compare interested, going, and went counts across event records alongside their names and start times.
Pro Tips
- Use a specific topic, activity, organization, or place phrase when a broad query returns unrelated event records.
- Set results_limit between 7 and 2,000 according to the coverage you need; omitting it requests the default 100 records.
- Use each event ID or public URL when merging repeated searches so the same event is not counted twice.
- Treat place, cover media, attendance counts, and event-state fields 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 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 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.