Facebook
GET /v1/facebook/event-search
Facebook Event Search API
Search Facebook programmatically and get structured, ranked results.
40 credits per request (2 per result)
TL;DR
Search Facebook programmatically and get structured, ranked results. The Facebook Event Search API (Facebook) is a single authenticated
GET request to /v1/facebook/event-search that responds with clean JSON, costs 40 credits, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.What is the Facebook Event Search API?
The Facebook Event Search API lets you search and return matching results from Facebook with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.
What you get
- Ranked, structured result list
- Title, URL, author, and thumbnail per result
- Engagement metrics where available
- Configurable result limit
Try it
Fill in the parameters below and copy a ready-to-run request in your language of choice.
Parameters
curl "https://api.captapi.com/v1/facebook/event-search?q=skincare" \
-H "Authorization: Bearer capt_live_..."Edit the parameters and the code updates instantly. Switch languages and hit copy.
Example response
{
"success": true,
"data": {
"query": "comedy Chicago",
"totalReturned": 5,
"events": [
{
"platform": "facebook",
"id": "1328780709218617",
"url": "https://www.facebook.com/events/1328780709218617/",
"name": "Matt Rife Chicago",
"description": "👉 Tickets https://tinyurl.com/yv83uw43\n\nMatt Rife brings his stand-up to Chicago on January 7, 2027 at 7:00 PM at United Center, offering a chance to see one of comedy’s most talked-about voices live. With his quick crowd work and sharp observations, the show should be an interesting night for anyone who follows modern stand-up. If you want to catch it in person, get tickets while they’re available.",
"startDate": "2027-01-08T01:00:00.000Z",
"startTime": "Thu, 7 Jan 2027 at 19:00 CST",
"duration": null,
"eventType": "PUBLIC",
"isOnline": false,
"isPast": false,
"isCanceled": false,
"address": null,
"image": "https://scontent.fman1-1.fna.fbcdn.net/v/t39.30808-6/724700053_122128289853202903_6582452006028980194_n.jpg?stp=dst-jpg_tt6&cstp=mx2048x1152&ctp=s2048x1152&_nc_cat=108&ccb=1-7&_nc_sid=75d36f&_nc_ohc=ms-d5PmPcwYQ7kNvwHf9XDV&_nc_oc=AdqOD2yhroMMJSNyqf5Zv2LorhfJfzTYkA959xWGUazbEkBllNdu9rF88W5SrqgXlXk&_nc_zt=23&_nc_ht=scontent.fman1-1.fna&_nc_gid=W9kBhIc_1YNyMRcLVrjJTQ&_nc_ss=7c289&oh=00_AQB8Vr1dCNqsiVMANmWvreMBFHmgW4Cefeh6CvmyuiHkJw&oe=6A4DEF52",
"usersGoing": 1,
"usersInterested": null,
"usersResponded": 1,
"location": {
"name": "United Center",
"city": "Chicago, IL",
"latitude": 41.880599043768,
"longitude": -87.673998328716,
"countryCode": "US"
},
"organizer": "Event by Encore Stage Network",
"organizers": [
{
"id": "61586087115672",
"name": "Encore Stage Network",
"url": "https://www.facebook.com/people/Encore-Stage-Network/61586087115672/",
"verified": false
}
],
"ticketsUrl": "https://tinyurl.com/yv83uw43",
"categories": [
{
"url": "https://www.facebook.com/events/search/?filters=eyJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5OjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5XCIsXCJhcmdzXCI6XCI2NjAwMzI2MTc1MzYzNzNcIn0ifQ%3D%3D&q=Comedy",
"label": "Comedy"
}
],
"externalLinks": [
"https://tinyurl.com/yv83uw43"
]
},
{
"platform": "facebook",
"id": "4388358051479036",
"url": "https://www.facebook.com/events/4388358051479036/",
"name": "Best of Chicago Stand-up Comedy",
"description": "Chicago has built a reputation as one of the most creative and influential comedy hubs in the country. For decades, the city has been a launchpad for distinctive voices that have gone on to shape the national comedy landscape. \r\n \r\nNow it’s time for the next wave. A fresh generation of comics is ready to hit the stage with bold, unforgettable performances. Expect nothing less than a tour de force of the city’s sharpest, funniest talent. \r\n \r\nTICKETS: $31.00 A Seats | $26.00 B Seats (Including Fees)\r\n \r\n Any questions? Call the Opera House Box Office: (815) 338-5300 or email tickets@woodstockil.gov",
"startDate": "2026-07-04T00:30:00.000Z",
"startTime": "Fri, Jul 3 at 7:30 PM CDT",
"duration": null,
"eventType": "PUBLIC",
"isOnline": false,
"isPast": false,
"isCanceled": false,
"address": null,
"image": "https://scontent.flis11-2.fna.fbcdn.net/v/t39.30808-6/716671852_1574982324635825_5812897137628490055_n.jpg?stp=dst-jpg_tt6&cstp=mx1200x444&ctp=s1200x444&_nc_cat=109&ccb=1-7&_nc_sid=75d36f&_nc_ohc=k50RjU74QGUQ7kNvwGADB3M&_nc_oc=AdpoAy068RZdoyu5Me-PbNewUWOn47ofvWT4XfVFeMWt_Cq_fiIEjD3EKVwJU_LTjQs&_nc_zt=23&_nc_ht=scontent.flis11-2.fna&_nc_gid=Wg7JdrPUNUMZB4upN7HKsw&_nc_ss=7c289&oh=00_AQA06lQs117SJN29MWKDg7sSIr1UfjFDYT2k96wCHmSoQw&oe=6A4DFA5A",
"usersGoing": 5,
"usersInterested": 21,
"usersResponded": 26,
"location": {
"name": "121 West Van Buren Street\r\nWoodstock, IL 60098",
"city": null,
"latitude": 42.31422,
"longitude": -88.44763,
"countryCode": "US"
},
"organizer": "Event by Woodstock Opera House",
"organizers": [
{
"id": "100063722163729",
"name": "Woodstock Opera House",
"url": "https://www.facebook.com/woodstockoperahouse",
"verified": false
}
],
"ticketsUrl": "https://www.etix.com/ticket/servlet/s/38224107",
"categories": [],
"externalLinks": []
},
{
"platform": "facebook",
"id": "1933940383960490",
"url": "https://www.facebook.com/events/1933940383960490/",
"name": "Splou At Riddles Comedy Club (Chicago)",
"description": "CHICAGOOOOOO! 🎤🔥\n\nOn July 12th, your boy is finally touching down in the Windy City for the very first time!\nFor ONE NIGHT ONLY, I’ll be performing at Riddles Comedy Club located at 5055 W. 111th St, Alsip, IL 60803.\n\nIf you’ve ever supported me, laughed with me, shared my content, or just been meaning to come out to a show, this is the perfect opportunity. Since it’s my first time in Chicago, I’m hoping y’all show up and help make it a night to remember!\n\nCome kick back, laugh, and create some unforgettable memories with me. Bring your friends, bring your family, and let’s pack the room with good vibes and great energy.\n\nI can’t wait to meet all of you and experience Chicago the right way. See y’all on July 12th! 🙌🏽❤️😂",
"startDate": "2026-07-12T21:00:00.000Z",
"startTime": "Sun, 12 Jul at 16:00 CDT",
"duration": null,
"eventType": "PUBLIC",
"isOnline": false,
"isPast": false,
"isCanceled": false,
"address": null,
"image": "https://scontent.fpnq19-1.fna.fbcdn.net/v/t39.30808-6/719533052_122172788750900739_7634339858905626068_n.jpg?stp=dst-jpg_tt6&cstp=mx427x640&ctp=s427x640&_nc_cat=110&ccb=1-7&_nc_sid=75d36f&_nc_ohc=5AR3F-g8wNIQ7kNvwEedc2a&_nc_oc=AdrCZzu-2lTmCEEkdi2A2ZLyq4sI20yR37F7Y9gq_00otMx8GNi75__iSwWHVw2VAZM&_nc_zt=23&_nc_ht=scontent.fpnq19-1.fna&_nc_gid=_pm45WXbADjb-OJcQXgdqw&_nc_ss=72289&oh=00_AQCPfrt_toX9IEctPTwhxS19vDNGYeunaMSNU4ASegk3ZA&oe=6A4DF74A",
"usersGoing": 2,
"usersInterested": null,
"usersResponded": 2,
"location": {
"name": "Riddles Comedy Club",
"city": "Alsip, IL, United States",
"latitude": 41.690316215,
"longitude": -87.745052889,
"countryCode": "US"
},
"organizer": "Event by Splou Yorkcity",
"organizers": [
{
"id": "61577022191152",
"name": "Splou Yorkcity",
"url": "https://www.facebook.com/people/Splou-Yorkcity/61577022191152/",
"verified": true
}
],
"ticketsUrl": "https://tr.ee/RljR9PPP-O",
"categories": [
{
"url": "https://www.facebook.com/events/search/?filters=eyJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5OjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5XCIsXCJhcmdzXCI6XCI2NjAwMzI2MTc1MzYzNzNcIn0ifQ%3D%3D&q=Comedy",
"label": "Comedy"
}
],
"externalLinks": []
},
{
"platform": "facebook",
"id": "1425279479131652",
"url": "https://www.facebook.com/events/1425279479131652/",
"name": "Anton Lirnik Stand-Up Comedy in Chicago",
"description": "Anton Lirnik Stand-Up comedy show in Chicago! Супер событие в США. Антон Лирник едет к вам, чтобы доказать жизнь после Comedy Club не просто существует — она невероятно смешная. \n\nАнтон Лирник — легендарная половина «Дуэта имени Чехова». Тот самый голос, который узнаётся с первых секунд. Один из самых душевных тренеров «Лиги Смеха», сценарист, музыкант и просто мужчина в самом расцвете юмористических сил. Вас ждёт особенное шоу.\n\nFri. October 23rd, Doors: 8:00PM Show: 9:00PM\nPassage- 577 Waukegan Rd, Northbrook, IL 60062",
"startDate": "2026-10-24T02:00:00.000Z",
"startTime": "Fri, 23 Oct at 21:00 CDT",
"duration": null,
"eventType": "PUBLIC",
"isOnline": false,
"isPast": false,
"isCanceled": false,
"address": null,
"image": "https://scontent.fbhx7-1.fna.fbcdn.net/v/t39.30808-6/709078752_1675367390797344_4435915260643962635_n.jpg?stp=dst-jpg_tt6&cstp=mx1734x907&ctp=s960x960&_nc_cat=102&ccb=1-7&_nc_sid=75d36f&_nc_ohc=R7cEmWgmnfsQ7kNvwGQ_X0K&_nc_oc=Adr5bEb1hB9LLswt8rqCzJJDDunl9qOtk-gYSOs32zrbyvPcvBkH7VvcV9ouC4OvQBE&_nc_zt=23&_nc_ht=scontent.fbhx7-1.fna&_nc_gid=W0YYLBHgjn93DjExoc6wrQ&_nc_ss=72289&oh=00_AQBPh7k7NPfM1SaBgzWWy9p2O5YMtHodKy0fKAPoFNNT5w&oe=6A4DE38C",
"usersGoing": null,
"usersInterested": null,
"usersResponded": null,
"location": {
"name": "Passâge Event Venue",
"city": null,
"latitude": 42.144942615,
"longitude": -87.827913782,
"countryCode": "US"
},
"organizer": "Event by The Reunion Parties and Passâge Event Venue",
"organizers": [
{
"id": "100049722975732",
"name": "The Reunion Parties",
"url": null,
"verified": false
},
{
"id": "100063583810007",
"name": "Passâge Event Venue",
"url": "https://www.facebook.com/passagevenue",
"verified": false
}
],
"ticketsUrl": "https://thereunionparties.com/buy/index.php?cPath=588",
"categories": [],
"externalLinks": []
},
{
"platform": "facebook",
"id": "852712190975134",
"url": "https://www.facebook.com/events/852712190975134/",
"name": "John Mulaney TICKETS",
"description": "John Mulaney is a master storyteller with razor-sharp wit, delivering clever, self-aware comedy that turns everyday moments into unforgettable laughs.\n\n#JohnMulaney #StandUpComedy #ComedyIcon #LiveLaughs #SmartHumor",
"startDate": "2026-07-12T01:00:00.000Z",
"startTime": "Sat, Jul 11 at 8:00 PM CDT",
"duration": null,
"eventType": "PUBLIC",
"isOnline": false,
"isPast": false,
"isCanceled": false,
"address": null,
"image": "https://scontent-yyz1-1.xx.fbcdn.net/v/t39.30808-6/616457886_122276415578033961_8909231014069597674_n.webp?stp=dst-jpg_tt6&cstp=mx1199x632&ctp=s1199x632&_nc_cat=108&ccb=1-7&_nc_sid=75d36f&_nc_ohc=NwAsaY5ji-MQ7kNvwGs5Tec&_nc_oc=Adq0FFzxys0foqMdlH4dpd5mEcnZrPvLqAkL9pQEsjPfIxMz9yxEMzebyTM3m2XJECY&_nc_zt=23&_nc_ht=scontent-yyz1-1.xx&_nc_gid=6gQnybBH5_J541LAmwNTfw&_nc_ss=7c289&oh=00_AQBpSae0dX6uCXpjfZ9hONe7IUUYbIGRh7USiXC16UZGAg&oe=6A4DF8D0",
"usersGoing": 1,
"usersInterested": 1,
"usersResponded": 2,
"location": {
"name": "Wrigley Field — Chicago, Ill.",
"city": "Chicago, IL",
"latitude": 41.94816,
"longitude": -87.65565,
"countryCode": "US"
},
"organizer": "Event by Grab Tickets Now",
"organizers": [
{
"id": "61551018854210",
"name": "Grab Tickets Now",
"url": "https://www.facebook.com/Grabticketsnowusa",
"verified": false
}
],
"ticketsUrl": "https://www.grabticketsnow.com/tickets/7433971/john-mulaney-tickets-sat-jul-11-2026-wrigley-field?utm_source=facebook&utm_medium=socialmediapost&utm_campaign=PRA",
"categories": [
{
"url": "https://www.facebook.com/events/search/?filters=eyJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5OjAiOiJ7XCJuYW1lXCI6XCJmaWx0ZXJfZXZlbnRzX2NhdGVnb3J5XCIsXCJhcmdzXCI6XCI2NjAwMzI2MTc1MzYzNzNcIn0ifQ%3D%3D&q=Comedy",
"label": "Comedy"
}
],
"externalLinks": [
null,
null,
null,
null,
null
]
}
]
}
}Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.
Response structure
A successful call returns success, cached, creditsUsed, and a data object with the following fields:
Top-level fields
queryThe search query you sent.totalReturnedNumber of items returned in this response.
Events
Each item in events contains:
platformPlatform identifier (e.g. youtube, instagram).idStable platform ID for the item.urlCanonical URL of the item.nameName of the item or account.descriptionDescription text.startDateStart date. Example: "2027-01-08T01:00:00.000Z".startTimeStart time. Example: "Thu, 7 Jan 2027 at 19:00 CST".durationLength in seconds.eventTypeEvent type. Example: "PUBLIC".isOnlineIs online. Example: false.isPastIs past. Example: false.isCanceledIs canceled. Example: false.addressAddress.imageImage URL.usersGoingUsers going. Example: 1.usersInterestedUsers interested.usersRespondedUsers responded. Example: 1.locationObject with name, city, latitude, longitude, countryCode.organizerOrganizer. Example: "Event by Encore Stage Network".organizersArray of objects with id, name, url, verified.ticketsUrlTickets url URL.categoriesArray of objects with url, label.externalLinksExternal links (array).
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. |
Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 40 credits — billed per result, so the exact amount scales with how many items you request. Repeat calls for the same request are served from cache for free (metrics refresh within ~1 hour).
Using an AI agent? This endpoint is the MCP tool
facebook_event_search via @captapi/mcp. Set it up →How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Send one request to
/v1/facebook/event-searchand parse the JSON response.
Use cases
Trend Discovery
Find trending content by keyword or hashtag.
Content Sourcing
Build feeds and playlists programmatically.
Monitoring
Track topics, brands, and competitors.
Research
Sample large sets of content for analysis.
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 scraping setup required.
How many credits does the Facebook Event Search API cost?+
Each successful call costs 40 credits. Responses are cached for 24 hours, and cached results cost 0 credits. 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, and Rumble. 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, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.
More Facebook APIs
Facebook Details APIFacebook Transcript APIFacebook Summarizer APIFacebook Comments APIFacebook Page Details APIFacebook Profile Posts APIFacebook Profile Reels APIFacebook Group Posts APIFacebook Comment Replies APIFacebook Marketplace Search APIFacebook Marketplace Location Search APIFacebook Event Details APIFacebook Profile Photos APIFacebook Profile Events APIFacebook Marketplace Item API
Ready to use the Facebook Event Search API?
Sign up, grab your key, and make your first call in 60 seconds.