Facebook · Guide

How to run a Facebook event search

TL;DR

To run a Facebook event search, sign up for a free Captapi key, then send one GET request to /v1/facebook/event-search with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Run a Facebook event search and get structured, ranked results as clean JSON.

Get your free API key API reference

How to run a Facebook event search (step by step)

1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
2
Call the Facebook Event Search API
Send an authenticated GET request to /v1/facebook/event-search with your input. No OAuth, no scraping setup.
3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/facebook/event-search?q=comedy%20Chicago" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "query": "comedy Chicago",
    "totalReturned": 5,
    "events": [
      {
        "platform": "facebook",
        "id": "1032731593052809",
        "url": "https://www.facebook.com/events/1032731593052809/",
        "name": "Worship 7/26/26",
        "startDate": "2026-07-26T15:00:00Z",
        "startTime": "Happening now",
        "eventType": "PUBLIC_TYPE",
        "isOnline": true,
        "isPast": false,
        "image": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.30808-6/729784843_1477362577754903_401694802381250350_n.jpg?stp=c0.47.1640.782a_dst-jpg_tt6&cstp=mx1640x782&ctp=s320x320&_nc_cat=101&ccb=1-7&_nc_sid=75d36f&_nc_ohc=6svKiDO2hVoQ7kNvwHjAlFx&_nc_oc=Adrs2rdq3CgIbPLXRlU5a0xVHUuey7lwAVdgpSxj7-fa3XGPZsdFBnUw7t8dgFeQLzo&_nc_zt=23&_nc_ht=scontent-ord5-1.xx&_nc_gid=ZJcMLEDMfuHRFLFJrYmanw&_nc_ss=7b289&oh=00_AQCUn-lzpgnqH0uhjhE6MWQWKlFJn71UKBsSHV-Uo_oxzw&oe=6A6BEE8A",
        "usersGoing": 3,
        "usersInterested": 1
      },
      {
        "platform": "facebook",
        "id": "1020197857054108",
        "url": "https://www.facebook.com/events/1020197857054108/",
        "name": "In-Person and Online Worship Experience",
        "startDate": "2026-07-26T16:00:00Z",
        "startTime": "Sun, Jul 26 at 11:00 AM CDT",
        "eventType": "PUBLIC_TYPE",
        "isOnline": true,
        "isPast": false,
        "image": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.30808-6/744332103_1423888923105270_3051096675327242426_n.jpg?stp=c0.19.1200.573a_dst-jpg_tt6&cstp=mx1200x573&ctp=s320x320&_nc_cat=109&ccb=1-7&_nc_sid=75d36f&_nc_ohc=yib12OViOYUQ7kNvwE_daPf&_nc_oc=AdobfdQpY8SDFjT_xffOD9zJrsspqBb4B3Zycu79SvflFYdBXd_TpK-XKLASAXhgncM&_nc_zt=23&_nc_ht=scontent-ord5-3.xx&_nc_gid=ZJcMLEDMfuHRFLFJrYmanw&_nc_ss=7b289&oh=00_AQCpkrtpEZGrupU8PePBJk5UM-MlMsiV0T956Jq0JAmViA&oe=6A6C0BDE",
        "usersGoing": 1,
        "usersInterested": 1
      },
      {
        "platform": "facebook",
        "id": "1411120507064710",
        "url": "https://www.facebook.com/events/1411120507064710/",
        "name": "Sanjeevani4U Monthly Support Group",
        "startDate": "2026-07-26T20:30:00Z",
        "startTime": "Sun, Jul 26 at 3:30 PM CDT",
        "eventType": "PUBLIC_TYPE",
        "isOnline": true,
        "isPast": false,
        "image": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.30808-6/613646701_1298582932295083_3210622313165210617_n.jpg?stp=c0.346.1024.488a_dst-jpg_tt6&cstp=mx1024x488&ctp=s320x320&_nc_cat=101&ccb=1-7&_nc_sid=75d36f&_nc_ohc=lwwuvCXsIw4Q7kNvwFMpt-c&_nc_oc=AdrRTviYP5UFmTyuWzFJZLH1ak6ofRtzwqOFOuG8gd-lsL-yslvJuSX7cUKqSKAYFuA&_nc_zt=23&_nc_ht=scontent-ord5-1.xx&_nc_gid=ZJcMLEDMfuHRFLFJrYmanw&_nc_ss=7b289&oh=00_AQCBrwR61TAz3t76nzzrYrX7s-IY5O2rfsoqBdftoIwt_A&oe=6A6C01E6",
        "usersGoing": 1
      },
      {
        "platform": "facebook",
        "id": "1552110089604110",
        "url": "https://www.facebook.com/events/1552110089604110/",
        "name": "The Big Picture of the Bible",
        "startDate": "2026-07-28T00:45:00Z",
        "startTime": "Mon, Jul 27 at 7:45 PM CDT",
        "eventType": "PUBLIC_TYPE",
        "isOnline": true,
        "isPast": false,
        "image": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.30808-6/723103611_1437329531770331_3863440088136803669_n.jpg?stp=c0.275.1080.516a_dst-jpg_tt6&cstp=mx1080x516&ctp=s320x320&_nc_cat=107&ccb=1-7&_nc_sid=75d36f&_nc_ohc=qi1dWulJN-QQ7kNvwGdr1lG&_nc_oc=Adpno_IqyRgRAlG3Z_Vfr1ul5XSlJdB1QrOjGKeBBwzYjz1oVZ5D4dS7sGlh-wdp23k&_nc_zt=23&_nc_ht=scontent-ord5-3.xx&_nc_gid=ZJcMLEDMfuHRFLFJrYmanw&_nc_ss=7b289&oh=00_AQDroLHQxAlYptc7KJaSOkLp9E3J3aGMZv5JD9viL4DmaA&oe=6A6BF0D4",
        "usersGoing": 1,
        "usersInterested": 2
      },
      {
        "platform": "facebook",
        "id": "2448238608938396",
        "url": "https://www.facebook.com/events/2448238608938396/",
        "name": "Virtual 8 Week Tarot Class - A Fool's Journey",
        "startDate": "2026-07-30T00:00:00Z",
        "startTime": "Wed, Jul 29 at 7:00 PM CDT",
        "eventType": "PUBLIC_TYPE",
        "isOnline": true,
        "isPast": false,
        "image": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.30808-6/700483218_122234764490315776_10588253747618528_n.jpg?stp=c0.177.1024.488a_dst-jpg_tt6&cstp=mx1024x488&ctp=s320x320&_nc_cat=106&ccb=1-7&_nc_sid=75d36f&_nc_ohc=LCRzJKfWiKsQ7kNvwFgKR6w&_nc_oc=Adr0yn7Dhw7TfiWnVXaiYKjY79rqYJ7O0ci5ovVd8gxV0JLjAWxLsc5d_elJVsJ9zKk&_nc_zt=23&_nc_ht=scontent-ord5-1.xx&_nc_gid=ZJcMLEDMfuHRFLFJrYmanw&_nc_ss=7b289&oh=00_AQD5PDmVcflFNfOcCytfj6iAK7Q2t_Ol4M2xCzz26mezCg&oe=6A6C025D",
        "usersGoing": 1
      }
    ]
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

Name	Type	Required	Description
q	string	Yes	Topic and/or place, e.g. 'comedy Chicago'.
limit	integer	No	Max items to return (default 20, max 200). Billed per result.
cache	boolean	No	Set true to serve from the 24h response cache. Default false — always fetch fresh data.

Frequently asked questions

What does the Facebook Event Search API do?

The Facebook Event Search API lets you search and return matching results from a public Facebook query using one GET request to /v1/facebook/event-search. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Facebook Event Search API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Failed or empty results are never charged.

Do I need a Facebook API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Facebook Event Search API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to run a Facebook event search?

Start free with 100 credits — no credit card required.

Get your free API key