How to run a Facebook Events event search
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. Search Facebook events by topic and city — local startDate/timezone, venue. 2 credits.How to run a Facebook Events 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",
"location": "Chicago",
"totalReturned": 5,
"events": [
{
"platform": "facebook",
"id": "1501904507609251",
"url": "https://www.facebook.com/events/1501904507609251/",
"name": "The Best of Chicago Comedy Showcase at Zanies Rosemont",
"description": "Get ready for an unforgettable evening of laughter as Chicago's comedy scene brings its A-game to the stage! \"The Best of Chicago Showcase\" features a dynamic lineup of the city's funniest stand-up comedians, delivering a blend of fresh, cutting-edge material and beloved, time-tested jokes.",
"startDate": "2026-08-19T19:00:00-05:00",
"endDate": "2026-08-19T20:30:00-05:00",
"timezone": "America/Chicago",
"startTime": "Wednesday 19 August 2026 from 19:00-20:30 CDT",
"duration": "1 hr 30 min",
"durationSeconds": 5400,
"eventType": "Comedy",
"isOnline": false,
"isPast": false,
"isCanceled": false,
"address": "5437 Park Pl, Des Plaines, IL 60018-3732, United States",
"image": "https://lookaside.fbsbx.com/lookaside/crawler/media/?media_id=1501904507609251",
"location": {
"name": "5437 Park Place, Rosemont, IL, United States, Illinois 60018",
"city": "Rosemont, IL",
"latitude": 41.97826,
"longitude": -87.86738,
"countryCode": "US"
},
"organizers": [
{
"id": "100064546187809",
"name": "Zanies Rosemont Comedy Club",
"url": "https://www.facebook.com/RosemontZanies",
"verified": false
}
],
"ticketsUrl": "https://www.etix.com/ticket/p/74170542/the-best-of-chicago-showcase-rosemont-zanies-rosemont",
"categories": [
{
"label": "Comedy",
"url": "https://www.facebook.com/events/search/?filters=eyJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5OjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5XCIsXCJhcmdzXCI6XCI2NjAwMzI2MTc1MzYzNzNcIn0ifQ%3D%3D&q=Comedy"
}
]
},
{
"platform": "facebook",
"id": "1345542687414105",
"url": "https://www.facebook.com/events/1345542687414105/",
"name": "Anthony Mrocka at Zanies Rosemont",
"startDate": "2026-08-05T19:00:00-05:00",
"timezone": "America/Chicago",
"startTime": "Wed, Aug 5 at 7:00 PM CDT",
"eventType": "PUBLIC_TYPE",
"isPast": false,
"isCanceled": false,
"location": {
"name": "5437 Park Place, Rosemont, IL, United States, Illinois 60018",
"city": "Rosemont, IL",
"countryCode": "US"
},
"organizers": [
{
"id": "100064546187809",
"name": "Zanies Rosemont Comedy Club",
"url": "https://www.facebook.com/RosemontZanies",
"verified": false
}
]
}
]
}
}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 keyword, e.g. 'comedy'. Pair with location for city-scoped results. |
| location | string | No | City/place geo filter (e.g. London). Matches timezone, location.city, or coords near the city — not a title substring. |
| from | string | No | Inclusive local start date filter YYYY-MM-DD. Use for upcoming-only windows — Facebook/SERP may return past events. |
| to | string | No | Inclusive local start date filter YYYY-MM-DD. |
| upcoming | boolean | No | When true and from is omitted, sets from to today's UTC date so past events are dropped. |
| limit | integer | No | Max items to return (default 20, max 200). Flat 2 credits per call. Response `source` is native or extended (fetch path — not a price change). |
| cache | boolean | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits. |
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 Events 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 cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.
Do I need a Facebook Events 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 cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
Ready to run a Facebook Events event search?
Start free with 100 credits — no credit card required.
Get your free API key