Events

Search upcoming events

Upcoming events in one metro, filtered. Every parameter is optional; with none you get Boston, chronological.

get/events

Request

  • Base URL: https://findlocal.community/api/playground
  • URL: https://findlocal.community/api/playground/events
  • Auth: HTTP bearer

Query parameters

city'ann-arbor' | 'atlanta' | 'austin' | 'baltimore' | 'bangor' | 'bloomington' | 'boise' | 'boston' | 'brattleboro' | 'buffalo' | 'burlington' | 'cape-cod' | 'charleston' | 'charlotte' | 'chicago' | 'cincinnati' | 'cleveland' | 'columbia-mo' | 'columbus' | 'dallas' | 'denver' | 'des-moines' | 'detroit' | 'duluth' | 'fort-collins' | 'grand-rapids' | 'green-bay' | 'hanover' | 'harrisburg' | 'hartford' | 'hilton-head' | 'houston' | 'hudson-valley' | 'indianapolis' | 'iowa-city' | 'jersey-shore' | 'kansas-city' | 'lansing' | 'las-vegas' | 'lincoln' | 'london' | 'los-angeles' | 'madison' | 'manchester' | 'miami' | 'milwaukee' | 'minneapolis' | 'nashville' | 'new-haven' | 'new-orleans' | 'new-york' | 'northampton' | 'oklahoma-city' | 'orlando' | 'philadelphia' | 'phoenix' | 'pittsburgh' | 'pittsfield' | 'portland' | 'portland-me' | 'portsmouth' | 'providence' | 'raleigh' | 'rochester' | 'rockland' | 'rutland' | 'sacramento' | 'salt-lake-city' | 'san-antonio' | 'san-diego' | 'san-francisco' | 'santa-barbara' | 'seattle' | 'sonoma' | 'spokane' | 'st-louis' | 'stamford' | 'tampa' | 'traverse-city' | 'tucson' | 'washington' | 'wenatchee' | 'wilmington-nc' | 'worcester'

Metro slug (or name). One of 84 metros (US and UK).

whenstring
Example:anytime

Date window, resolved in the metro's own time zone — or one day as YYYY-MM-DD.

date_fromstring date

Inclusive start day (YYYY-MM-DD) of an explicit window; used when when is absent. Defaults to today.

date_tostring date

Inclusive end day (YYYY-MM-DD) of an explicit window; used when when is absent. Open-ended when omitted.

updated_sincestring date-time

Incremental sync: only events changed at or after this ISO-8601 instant, delisted ones included (is_deleted: 1). Pass the previous response's meta.synced_at.

catstring
Example:music

Comma list of category slugs. literary also matches everything at bookstores and libraries.

free'1'

Free events only.

paid'1'

Paid events only.

maxnumber

Maximum price in the city's local currency (USD for US metros, GBP for London; events with a parsed price).

todstring
Example:morning

Comma list of times of day.

regionstring

Neighborhood / sub-area inside the metro, e.g. Cambridge.

qstring

Free text, matched word by word (up to 4 words; every word must match): event title, venue name, neighbourhood/town, description, performer and author names, and linked book titles. Common words like "the" and "in" are ignored.

performerstring

Substring match on performer names only.

authors'1'

Only events with a known author on the bill.

nearstring

Proximity search: <lat>,<lng>. Orders by distance and overrides sort.

radius_kmnumber

Radius for near (default 25, max 200).

sort'featured' | 'date'

date is chronological; featured is the site's editorial ranking.

pageinteger

1-based page of limit rows (100 when no limit). Ignored by the playground server.

limitinteger

Rows per call (max 500). The playground server caps this at 5 (100 signed in).

venuestring uuid

A venue uuid: upcoming events at that venue (the metro comes from the venue).

Response

Events plus paging metadata.

Changes

No recorded changes to this operation across all 1 revision of this API.