CaptapiCaptapi
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 40 credits per call — no OAuth, scraping or platform SDKs. Search Facebook programmatically and get structured, ranked results.
Get your free API keyAPI reference

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

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 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. 3

    Read the JSON response

    Parse the clean JSON response. Results are cached for 24 hours, so repeat calls are free.

Code example

curl "https://api.captapi.com/v1/facebook/event-search?q=skincare" \
  -H "Authorization: Bearer capt_live_..."

What the response looks like

{
  "success": true,
  "cached": false,
  "creditsUsed": 40,
  "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
        ]
      }
    ]
  }
}

Request parameters

NameTypeRequiredDescription
qstring YesTopic and/or place, e.g. 'comedy Chicago'.
limitintegerNoMax items to return (default 20, max 200). Billed per result.

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.

Ready to run a Facebook event search?

Start free with 100 credits — no credit card required.

Get your free API key