API Direct

Facebook Search Events

GET /v1/facebook/events

Search Facebook events by keyword across all of Facebook. Returns event names, event IDs, and direct event page links. Supports pagination, date filtering, and location filtering.

Cost

$0.008 per page

Free tier

50 requests/month

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch (1-10, default 1). Billed per page.

start_date

Filter events from this date (YYYY-MM-DD)

end_date

Filter events until this date (YYYY-MM-DD)

location_id

Facebook location ID to scope results to a place (resolve one via Search Locations)

Example Request

curl "https://apidirect.io/v1/facebook/events?query=music%20festival&start_date=2026-08-01" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/facebook/events",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "music festival",
        "start_date": "2026-08-01"
    }
)
print(response.json())

Example Response

{
  "events": [
    {
      "event_id": "1613570396584259",
      "title": "3rd Island Music Festival",
      "url": "https://www.facebook.com/events/1613570396584259/"
    },
    {
      "event_id": "947635377782868",
      "title": "Outlaw Festival: Willie Nelson, Wilco, Sheryl Crow & More!",
      "url": "https://www.facebook.com/events/947635377782868/"
    }
  ],
  "count": 2,
  "pages": 1
}

Your Usage

Free tier this month

Recent Activity