US and UK local events API

FindLocal launched an events API covering 86,498 upcoming events from 14,921 venues in 84 metros across the US and UK, served as a JSON REST API and an MCP server under a single API key. The service requires a Bearer token for its /api/events, /api/events/{id} and /api/venues endpoints, meters calls against a monthly credit quota, and requires Free-plan users to display an "Event data by FindLocal" attribution link. A free account at findlocal.community/signup issues up to 5 named keys per account, and a browser playground runs real queries at 5 rows per call.

86,498 upcoming events from 14,921 venues in 84 metros across the US and UK — the concerts and the bookshop readings, free events included. One key for the JSON API and the MCP server. You are helping me integrate the FindLocal Events API into my project. Follow these steps, then use the reference below — do not invent endpoints or parameters that are not in it. 1. Ask me what I am building and which metro s I need, if I have not said. 2. Read my API key from the environment variable FINDLOCAL KEY. Never hard-code or log it. If I do not have one, tell me to create a free account at https://findlocal.community/signup and mint a key at https://findlocal.community/dashboard/keys. 3. Write a small typed client for the endpoints I need, matching my project's language and HTTP library. 4. Handle 401 bad key , 429 wait Retry-After seconds, then retry and 503 back off . Cache responses for a few minutes — each call spends one credit from a monthly quota. 5. If the key is on the Free plan, render this link wherever events are displayed the terms require it; paid plans do not : <a href="https://findlocal.community" rel="noopener" Event data by FindLocal</a 6. Show me one working request and its trimmed response before building further. FindLocal Events API Hyper-local events for 84 metros across the US and UK — concerts, readings, film screenings, talks, classes, trivia, open mics, storytimes — with venues and coordinates. REST + an MCP server, one key for both. Human docs and playground: https://findlocal.community/docs · OpenAPI: https://findlocal.community/openapi.json Quickstart 1. Create a free account at https://findlocal.community/signup no card and mint a key at https://findlocal.community/dashboard/keys. 2. Send it as a Bearer token: bash curl "https://findlocal.community/api/events?city=boston&when=weekend&free=1" \ -H "Authorization: Bearer $FINDLOCAL KEY" 3. Read data events and meta total , page , page size . Page with page=2 . No key yet? The playground at https://findlocal.community/docs runs real queries in the browser, 5 rows a call. Authentication Every /api/events , /api/events/{id} and /api/venues call needs a key: Authorization: Bearer <key or X-API-Key: <key . Keep keys server-side where you can; a key in browser code is visible to anyone. One account can hold 5 named keys — use one per app so you can revoke them separately. The same key authorises the MCP server https://mcp.findlocal.community/mcp . Endpoints Base URL https://findlocal.community/api . JSON over HTTPS, GET only, CORS open. Responses are { "data": …, "meta": … } . GET https://findlocal.community/api/events Search upcoming events. Upcoming events in one metro, filtered. Every parameter is optional; with none you get Boston, chronological. See Filters — every parameter is optional. GET https://findlocal.community/api/events/{id} One event. A single event by id — past and delisted events included is deleted . - id required — string GET https://findlocal.community/api/venues Venues in a metro. Active venues with their upcoming-event counts. - city — Metro slug or name . One of: 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 . Default boston . - region — Neighborhood / sub-area. - q — Substring match on the venue name. - type — Venue type, case-insensitive: Music Venue, Performing Arts Center, Theater, Comedy Club, Bar, Nightclub, Brewery & Winery, Restaurant, Cafe, Bookstore, Library, Museum, Art Gallery, University & College, Arena & Stadium, Park & Outdoors, Community Center, Place of Worship, Market, Festival Grounds, Other. - sort — Order. One of: name , upcoming . Default name . - limit — Rows per page max 500; 100 from Nov 15, 2026 . Default 500 . - page — 1-based page; keep going while meta.has more . Default 1 . Event object - id string - title string - description string | null - event date string — Calendar day in the venue's own time zone. - start time string | null — HH:MM, 24-hour, venue-local. - end time string | null - category string | null — music | comedy | theater | dance | literary | film | talks | art | food drink | family | market | workshop | fitness | sports | nightlife | community | festival | parks - event type array — Type tokens as the source published them free text . - event types array — Event Intelligence: what kind of event this is, from a fixed vocabulary of 44 slugs e.g. concert , author-talk , trivia , stand-up . Empty until classified. - category confidence number | null — Event Intelligence: 0-1 confidence in category . Null when the category came from keywords or a person, not the classifier. - is real event integer | null — Event Intelligence: 1 = checked and is an attendable event; null = not checked yet. Rows judged not to be events closures, deadlines, placeholders are never served. - performers array — Who the event is by: the bill, authors, instructors, speakers. Empty when unknown. Search it with performer or q . - price string | null — Price label as published, e.g. "$18 adv / $22 door". - price amount number | null — Parsed lowest price in the city's local currency USD for US metros, GBP for London ; 0 = free. - status string | null — What the source states: scheduled | cancelled | postponed | rescheduled | sold out. Null when the source does not say. - detail page url string | null - ticket page url string | null - image url string | null - city string — Metro name. Its currency is the currency of price amount single-event responses carry no meta.currency . - region string | null - venue id string - venue name string - venue address string | null - venue lat number | null - venue lng number | null - venue url string | null - venue image string | null - venue region string | null - venue type string | null — The venue's type: Music Venue | Performing Arts Center | Theater | Comedy Club | Bar | Nightclub | Brewery & Winery | Restaurant | Cafe | Bookstore | Library | Museum | Art Gallery | University & College | Arena & Stadium | Park & Outdoors | Community Center | Place of Worship | Market | Festival Grounds | Other. - venue capacity integer | null — Venue capacity, when known. - venue size string | null — Small | Medium | Large | Unknown. - author ids array - book ids array - end date string | null — Last day YYYY-MM-DD of a multi-day run stored as one event: an exhibition, festival or trade show. Null for single-day events and for runs listed night by night those are separate events sharing series id . A run whose event date is past is still upcoming until end date . - series id string | null — Groups the occurrences of one thing: every night of a residency, every week of a quiz. Stable across scrapes; filter with series id= . - organizer string | null — Who puts the event on, when that is not the venue: a talk series, promoter, festival or council programme. The venue fields always describe where it happens. - duplicate of string | null — Set when the same show is also listed under another venue: the id of the event we keep. Such events are never in lists; by id and in updated since syncs they report is deleted: 1 . - series count integer — Upcoming dates of the same recurring event at this venue. - series image string | null — First image in the recurring series — a fallback when image url is empty. - books array — The books behind book ids title, isbn13, cover url, publisher, pub year… . Absent when there are none. - authors array — The authors behind author ids canonical name, photo url, bio, wikipedia url… . Absent when there are none. - is deleted integer — 1 when the source stopped listing it, or it is a cross-venue duplicate duplicate of . - updated at string Venue object - id string - name string - city string - region string | null - address string | null - latitude number | null - longitude number | null - type string | null — One of: Music Venue | Performing Arts Center | Theater | Comedy Club | Bar | Nightclub | Brewery & Winery | Restaurant | Cafe | Bookstore | Library | Museum | Art Gallery | University & College | Arena & Stadium | Park & Outdoors | Community Center | Place of Worship | Market | Festival Grounds | Other. - venue size string | null — Small | Medium | Large | Unknown. Small is under 100 people, Medium 100-499, Large 500+; derived from capacity when that is known, otherwise an estimate. - capacity integer | null — Maximum capacity people , when a source states one: Wikidata, the venue's own website, or a venue directory. null = unknown. - categories array - url string | null - image string | null - image attribution string | null — Credit line for image Wikimedia Commons / Openverse CC licenses . When present you must display it next to the image. - description string | null - upcoming integer — Upcoming non-deleted events at this venue. - wikidata id string | null — Matched Wikidata entity, e.g. Q123456. - wikipedia url string | null - image source string | null - description source string | null Filters GET /api/events - city — metro slug, default boston . 84 metros US and UK : 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 . - when — Date window, resolved in the metro's own time zone — or one day as YYYY-MM-DD. - date from — Inclusive start day YYYY-MM-DD of an explicit window; used when when is absent. Defaults to today. A multi-day run end date that started earlier but is still on is included. - date to — Inclusive end day YYYY-MM-DD of an explicit window; used when when is absent. Open-ended when omitted. - updated since — 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 . - cat — Comma list of category slugs. literary also matches everything at bookstores and libraries. - free — Free events only. One of: 1 . - paid — Paid events only. One of: 1 . - max — Maximum price in the city's local currency USD for US metros, GBP for London; events with a parsed price . - tod — Comma list of times of day. - region — Neighborhood / sub-area inside the metro, e.g. Cambridge. - q — 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. - performer — Substring match on performer names only. - series id — Every upcoming occurrence of one series an event's series id . - authors — Only events with a known author on the bill. One of: 1 . - near — Proximity search: <lat ,<lng . Orders by distance and overrides sort . The radius spans metros a point between Washington and Baltimore returns both; each event's city says which ; city then only sets the time zone for "today", and defaults to the metro nearest the point. - radius km — Radius for near default 25, max 200 . Default 25 . - sort — date is chronological; featured is the site's editorial ranking. One of: featured , date . Default date . - page — 1-based page of limit rows 100 when no limit . Ignored by the playground server. Default 1 . - limit — Rows per call max 500; 100 from Nov 15, 2026 . The playground server caps this at 5 100 signed in . - venue — A venue uuid: upcoming events at that venue the metro comes from the venue . Category slugs for cat : music , comedy , theater , dance , literary , film , talks , art , food drink , family , market , workshop , fitness , sports , nightlife , community , festival , parks . Errors Errors are JSON: { "error": "message" } . - 400 — a malformed parameter. - 401 — missing, invalid, expired or revoked key. - 404 — unknown event id. - 429 — per-minute rate limit exceeded, or the Free monthly quota is spent paid plans run on into billed overage . Honour Retry-After seconds . - 503 — key verification is briefly unavailable; retry with backoff. The API fails closed rather than serving unmetered. Rate limits and quotas Two limits apply. Both are per ACCOUNT: all of an account’s keys share one monthly quota REST and MCP calls alike; more keys never add calls , refilled on the 1st UTC , and one per-minute limit . - Free: 100 calls/month hard stop , 30 requests/minute - Indie: 10,000 calls/month, then $0.002 per extra call, 60 requests/minute - Business: 75,000 calls/month, then $0.002 per extra call, 120 requests/minute From Nov 15, 2026 every keyed call returns at most 100 rows 500 until then ; page with page= meta.has more on venues . Every successful response carries X-RateLimit-Remaining calls left this MONTH on the account , X-RateLimit-Limit requests per MINUTE and X-RateLimit-Reset Unix seconds when the minute window reopens . Each call costs one credit, cached or not. Unknown query parameters are ignored, never an error — meta.ignored params and the X-FindLocal-Warning header list them e.g. category → use cat . On 429 , wait Retry-After seconds. For bulk work, stay under the per-minute limit and cache results — events change at most a few times a day. To keep a copy in sync, fetch the window once, then poll with updated since=<meta.synced at : only changed rows come back, delisted ones as is deleted: 1 . Plans - Free: free, no card; 100 calls/month, hard stop; 30 requests/minute . For evaluating the API and personal projects. - Indie: $9/month launch price, locked in for life; $19/mo from Nov 15, 2026 ; 10,000 calls/month, then $0.002 per extra call; 60 requests/minute . For side projects and small apps. - Business: $49/month launch price, locked in for life; $99/mo from Nov 15, 2026 ; 75,000 calls/month, then $0.002 per extra call; 120 requests/minute . For production apps and agents. - Enterprise — more than Business custom quota, higher burst limit, invoicing : email elliot@findlocal.community. Paid plans never stop at the quota: calls past it are billed at $0.002 each on the next invoice. Free is for evaluation and personal projects. If we see signs of production use sustained traffic, a public deployment or commercial use , we may ask you to move to a paid plan. Event Intelligence event types , category confidence , is real event , performers' entity id / musicbrainz id / wikidata id , and the books / authors behind literary events is included on every plan. Upgrade, downgrade or cancel at https://findlocal.community/dashboard/billing. Existing keys move to the new limits at once. Attribution. On the Free plan, show a visible link back wherever the data is displayed — <a href="https://findlocal.community" rel="noopener" Event data by FindLocal</a or equivalent wording. Paid plans need no attribution. Full API terms caching, redistribution : https://findlocal.community/terms api. MCP server Endpoint: https://mcp.findlocal.community/mcp Streamable HTTP; OAuth 2.1 + PKCE . On first connect you paste an API key. - Claude Code: bash claude mcp add --transport http findlocal https://mcp.findlocal.community/mcp - Cursor ~/.cursor/mcp.json : json { "mcpServers": { "findlocal": { "url": "https://mcp.findlocal.community/mcp" } } } - Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → paste the endpoint. Event tools cost one credit per call; get usage , get api docs and get setup guide are free. Widgets no code An embeddable list, calendar or map — one script tag, free, no key. The widget is inserted after the tag: html <script src="https://findlocal.community/widget.js" data-city="boston" data-view="list" </script Attributes: data-widget a catalogue preset, e.g. literary-new-england , data-city one metro or a comma list of up to 25 , data-region , data-cat , data-when , data-from + data-to YYYY-MM-DD , data-view list | calendar | map | compact | strip — compact is a 5-event sidebar list, strip a row of 8 thumbnails; neither has filters , data-more your full events page: compact/strip link there and open a clicked event there , data-seo="off" no schema.org Event JSON-LD on your page; default on for list/calendar/map, off for compact/strip , data-theme light | dark | auto , data-limit 1-300 , data-height initial px , data-max-height px or none ; default 85% of the window, 420-900 px — past it the widget scrolls inside itself , data-partner , data-authors="1" only events with a known author , data-free="1" , data-near="<lat ,<lng " + data-radius km, default 25; replaces the metro scope , data-filters="off" hide the visitor filter toolbar . Dates and prices render in the metro's own locale and currency e.g. 24-hour times and £ for London . Visitors stay on the host site: clicking an event opens a details panel inside the widget, whose only outbound link is the venue's own ticket/event page. Live builder: https://findlocal.community/widgets. 100 calls a month free. No card. 86,498Upcoming events 51,774In the next 30 days 14,921Venues tracked 84Metros US + UK Counted from the live database on Oct 25, 2026. One GET. Real events. Request curl "https://findlocal.community/api/events?city=boston&when=weekend&free=1" \ -H "Authorization: Bearer $FINDLOCAL KEY" Response — live, trimmed { "data": { "id": "799b5db3-bfe0-419c-9d1c-61562822047c", "title": "Poetry Days Presents: An Evening with Victoria Chang", "event date": "2026-10-28", "start time": "19:00", "category": "literary", "price": "Free", "venue name": "Boston College", "region": "Boston" } , "meta": { "city": "Boston", "total": "…", "page": 1 } } Filter by metro, date, category, price, time of day, neighborhood, text, performer — or near=lat,lng. Hyper-local: 4,301 trivia nights, 1,803 open mics, 1,484 karaoke nights and 1,952 storytimes among 86,498 upcoming events at 14,921 venues in 84 metros across the US and UK — counted live Ticketed events sold through Ticketmaster and its partners — no free trivia night, no bookshop readingsource Events created on Eventbrite — and not searchable by location since February 2020source “200M+ events listed globally” across 40k+ cities; no US figure publishedsource Whatever Google shows for the query — a live search per call, up to 500 results, not a cataloguesource Scraped Eventbrite listings plus organizer submissions Google search results and the Places API not affiliated with Google source Competitor details are as of September 2026 and may have changed; follow the source links. FindLocal's numbers are counted from the live database. Product names belong to their owners; this page is not affiliated with or endorsed by them. Something wrong? Email a correction and we'll fix it. Pricing Start free, no card. One key for the JSON API and the MCP server. Widgets are free. Need more than Business — a bigger quota, a higher burst limit, invoicing, or a data licence? Email elliot@findlocal.community for an enterprise plan. FAQ What makes it hyper-local? We read venues' own websites, so the catalogue has what never reaches a ticketing platform: 4,301 trivia nights, 1,803 open mics and 1,952 storytimes are upcoming right now, next to the concerts and theater. Where does the data come from? Straight from the source: each venue's own calendar page, re-read daily, with ticketing feeds for arena shows. Every event carries its venue, coordinates, neighborhood, category, price and a link back. Do I need a credit card to start? No. The free tier is 100 calls a month with no card. Sign up, create a key, make a request. Can I try it before signing up? Yes. The playground in the API docs runs real queries with no key, capped at a few rows per call. Does one key cover the API and the MCP server? Yes. The JSON API and the MCP server share one key and one monthly quota. Widgets are free and need no key at all. What happens when I hit my limit? On Free, requests past the monthly quota return 429 until the 1st. Paid plans never stop: calls past the quota cost $0.002 each on your next invoice. Indie is $9/month for 10,000 calls, Business $49/month for 75,000 launch prices, locked in for life if you subscribe before Nov 15, 2026 . Need more? Email elliot@findlocal.community. What is Event Intelligence? Every event is classified before it is published: a category, event types from a fixed vocabulary of 44, a confidence score, the performers on the bill, and a check that it is a real, attendable event closures, deadlines and placeholder rows are filtered out . It is included on every plan. Which cities are covered? 84 metros across the US and UK today — see the coverage map above, or run a query on any of them in Explore. Do I have to credit FindLocal? On the Free plan, yes: a small "Event data by FindLocal" link wherever the data appears. Paid plans need no attribution.