Skip to content
truescrape
Free key

Contents

Site

Facebook Events Search API

Open in ChatGPTOpen in ClaudeOpen in Gemini

Public Facebook events matching a search term. Results are ranked and biased toward where Facebook places the request, so the same query can return a different set on another call. Treat this as discovery, not as an enumerable list. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/facebook/events/search
ParameterTypeRequiredDescription
querystringyesWhat to search for, e.g. "jazz festival"

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/facebook/events/search?query=jazz%20festival&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  query: 'jazz festival',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/facebook/events/search?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/facebook/events/search",
    params={
        "query": "jazz festival",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "facebook",
        "id": "1602133408309700",
        "name": "OPENING NIGHT! ORRIN EVANS MEETS KURT ELLING",
        "url": "https://www.facebook.com/events/1602133408309700/",
        "description": null,
        "startsAt": null,
        "endsAt": null,
        "timeText": null,
        "isOnline": null,
        "isCanceled": null,
        "isPast": null,
        "place": null,
        "hostId": null,
        "hostName": null,
        "hostUrl": null,
        "thumbnailUrl": "https://scontent-nrt6-1.xx.fbcdn.net/v/t39.99422-6/814493625_1423994406343536_1394295435659869021_n.png?stp=c293.0.1463.1463a_cp0_dst-jpg_tt6&cstp=mx1463x1463&ctp=s64x64&_nc_cat=111&ccb=1-7&_nc_sid=80b81f&_nc_ohc=KXDWmgIKJQ0Q7kNvwHCfHqG&_nc_oc=AdqJ1A7OJt521IAivBF7xHTvaqFp12mcZA2dp8tTfverLl7_vXaoDBP_zmXvm6uP4ck&_nc_zt=14&_nc_ht=scontent-nrt6-1.xx&_nc_gid=I4ezxJemFxBKlxe3KQxx4Q&_nc_ss=70289&oh=00_AQNZKV-8FkWBPPmwoDAoEfvauKnOrGhKMIGQB5kpDrGb9A&oe=6ADDF96C",
        "ticketPriceText": null,
        "interestedCount": null,
        "fetchedAt": "2026-10-21T01:51:44.414Z"
      },
      {
        "platform": "facebook",
        "id": "1121879620384488",
        "name": "Leimert Park Jazz Festival presents Sunday Jazz at The World Stage",
        "url": "https://www.facebook.com/events/1121879620384488/",
        "description": null,
        "startsAt": null,
        "endsAt": null,
        "timeText": null,
        "isOnline": null,
        "isCanceled": null,
        "isPast": null,
        "place": null,
        "hostId": null,
        "hostName": null,
        "hostUrl": null,
        "thumbnailUrl": "https://scontent-nrt1-1.xx.fbcdn.net/v/t39.99422-6/833936732_1801338651000865_3797517968379668339_n.png?stp=c458.0.1005.1005a_cp0_dst-jpg_tt6&cstp=mx1005x1005&ctp=s64x64&_nc_cat=108&ccb=1-7&_nc_sid=80b81f&_nc_aid=0&_nc_ohc=mH3VCe3x3rkQ7kNvwGYFVqa&_nc_oc=AdrMbLxK9loWAMoR9C6eK9RJx8g-cq21MEbiqJT9ABaqIMngxHHafkkvLlvh4wRsktQ&_nc_zt=14&_nc_ht=scontent-nrt1-1.xx&_nc_gid=I4ezxJemFxBKlxe3KQxx4Q&_nc_ss=70289&oh=00_AQO5am_SZ3eqEAMF8qI_YdDuHh3j06m0H_1Bi7jcy3wZNQ&oe=6ADDFE5B",
        "ticketPriceText": null,
        "interestedCount": null,
        "fetchedAt": "2026-10-21T01:51:44.414Z"
      }
    ]
  },
  "pagination": {
    "cursor": null,
    "hasMore": true,
    "count": 11
  },
  "meta": {
    "platform": "facebook",
    "endpoint": "facebook.eventsSearch",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 4744,
    "requestId": "req_rsbhengvcp9m0p3cvi10"
  }
}

Returns

Returns a list of object in data.items.

Fields
FieldTypePresentDescription
platform"facebook"always
idstringalways
namestring | nullalways
urlstringalways
descriptionstring | nullalways
startsAtstring | nullalwaysISO 8601, UTC.
endsAtstring | nullalwaysISO 8601, UTC. Null when the event has no end time.
timeTextstring | nullalwaysFacebook's own rendering of the time, e.g. "Sat, Sep 5 at 3:00 PM MDT". It carries the event's LOCAL timezone, which the epoch timestamps do not.
isOnlineboolean | nullalways
isCanceledboolean | nullalways
isPastboolean | nullalways
placeobject | nullalways
place.idstring | nullalways
place.namestring | nullalways
place.addressstring | nullalways
place.latitudenumber | nullalways
place.longitudenumber | nullalways
hostIdstring | nullalways
hostNamestring | nullalways
hostUrlstring | nullalways
thumbnailUrlstring | nullalways
ticketPriceTextstring | nullalways
interestedCountnumber | nullalwaysPeople who marked the event Interested or Going. In list results above a thousand, Facebook's rounded figure ("1.2K").
fetchedAtstringalways

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableno

Other Facebook endpoints

All Facebook endpointsThe unified schema