Facebook Search Events API

Endpoint

GET /v1/facebook/events

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)

Response fields

events

Array of matching events

event_id

Event ID

title

Event name

url

Direct link to the event page

count

Number of events returned

pages

Number of pages fetched

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
}

Frequently asked questions

What event data is returned?

Each result includes the event name, its Facebook event ID, and a direct link to the event page.

How do I filter events by date?

Use start_date and end_date in YYYY-MM-DD format to narrow results to events happening within a specific time range. You can use one or both parameters.

How do I find events in a specific city?

Resolve the city to a Facebook location ID with the Search Locations endpoint, then pass it as location_id to scope results to that place.

How does pagination work?

Use the pages parameter to fetch multiple pages of results in a single request (1-10). Each page is billed separately. Default is 1 page.

How does pricing work?

You only pay for successful requests. The Facebook Search Events API costs $0.008 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.