Facebook Event Search API
Changed onSearch Facebook events by topic and city — local startDate/timezone, venue.
Search public Facebook events with a topic query (e.g. comedy) and optional location / from / to / upcoming filters. Each result uses the same Event shape as Event Details and Profile Events — every field present, null when Facebook omits it: startDate/endDate as ISO with the host timezone offset (calendar day matches startTime — evening CDT events do not roll to the next UTC day), IANA timezone (from venue lat/lng when present — never Etc/*), startTime (always includes the year), isPast, eventType (discovery category, e.g. Comedy), visibility (public|private|friends|… from Facebook's *_TYPE), location{name,city,latitude,longitude,countryCode} (all five keys always — null when unknown), description, image, organizers, ticketsUrl, categories, and usersGoing/usersInterested when exposed. Relative labels like "Happening now" are never returned as startTime. Billing: flat 2 credits on a 200. When no events can be read this time the call is a retryable 503 UPSTREAM_UNAVAILABLE at 0 credits. Envelope timings{serpMs,hydrateMs,hydrateAttempts,discoveryMs,totalMs,path} exposes per-stage latency. Set client timeouts ≥130s until typical searches stay under 60s.
Request
- Base URL: https://api.captapi.com
- URL: https://api.captapi.com/v1/facebook/event-search
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Query parameters
Topic keyword, e.g. 'comedy'. Pair with location for city-scoped results.
City/place geo filter (e.g. London). Matches timezone, location.city, or coords near the city — not a title substring.
Inclusive local start date filter YYYY-MM-DD. Use for upcoming-only windows — Facebook/SERP may return past events.
Inclusive local start date filter YYYY-MM-DD.
When true and from is omitted, sets from to today's UTC date so past events are dropped.
Max items to return (default 20, max 200). Flat 2 credits per call. Response source is native or extended (fetch path — not a price change).
Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Response
Success. The data object for this endpoint.
Changes
- breaking
the response property
///became nullable for the status - breaking
the response property
///became nullable for the status - breaking
the response property
///became nullable for the status - breaking
the response property
///became nullable for the status - breaking
the response property
///became nullable for the status - breaking
the response property
////became nullable for the status - breaking
the response property
///became nullable for the status - breaking
the response property
///became nullable for the status - breaking
the response property
///became nullable for the status
- breaking