Gary's Guide Events API
Live, read-only discovery of Gary's Guide regional and online events. Browse the source calendar with cursor pagination and filters for region, dates, keywords, venue, price, free status, online status, and source labels; retrieve full event details and registration links by source event ID.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the Gary's Guide Events API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/20baf11c-ef9a-4f42-acb5-ab8b7435d03e/v1/events' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETEvents/v1/events
Fetches the selected source calendar live. The source returns multiple calendar weeks in one document; this API filters that complete returned calendar and applies opaque cursor pagination after filtering. Region is source-native: nyc, sf, or online.
Input
regionOptionalQuery · "nyc" | "sf" | "online"Gary's Guide source calendar to read.
Example: nyc
date_fromOptionalQuery · string (date) | nullInclusive ISO date lower bound.
Example: 2026-10-01
date_toOptionalQuery · string (date) | nullInclusive ISO date upper bound.
Example: 2026-10-31
keywordOptionalQuery · string | nullCase-insensitive title, venue, address, or description substring.
Example: AI
venueOptionalQuery · string | nullCase-insensitive venue substring.
Example: Betaworks
freeOptionalQuery · boolean | nullWhen true, return source rows marked Free; when false, return paid rows.
Example: true
price_maxOptionalQuery · number, min: 0, max: 100000 | nullMaximum numeric dollar price; free events are not included unless free=true.
Example: 50
onlineOptionalQuery · boolean | nullFilter by the source's online calendar surface.
Example: false
source_labelOptionalQuery · "Popular Event" | "Gary Event" | "Featured Event" | "Sponsored Event" | nullSource-native row label preserved from the calendar image metadata.
Example: Featured Event
limitOptionalQuery · integer, min: 1, max: 100, default: 20Number of records per page.
Example: 20
cursorOptionalQuery · string | nullOpaque cursor from the prior response's next_cursor.
Response
dataobject[]data[].idstringdata[].date?string (date) | nulldata[].titlestringdata[].venue?string | nulldata[].labels?string[]data[].onlinebooleandata[].address?string | nulldata[].is_free?boolean | nulldata[].timezone?string | nulldata[].date_label?string | nulldata[].price_text?string | nulldata[].start_time?string | nulldata[].description?string | nulldata[].calendar_url?string | nulldata[].participants?string[]data[].price_amount?number | nulldata[].canonical_urlstringdata[].schedule_text?string | nulldata[].source_region?string | nulldata[].registration_url?string | nulltransport?string, default: curl_cffi_residentialrequest_idstringnext_cursor?string | nullFields marked ? are optional.
For the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.
GETEvents by event id/v1/events/{event_id}
Resolves the lowercase source event token through the current regional and online listing surfaces, then fetches the canonical detail page live. A token that is not currently listed is returned as a client 404.
Input
event_idRequiredPath · stringLowercase source event token returned by /v1/events.
Example: zfj5xxd
Response
dataobjectdata.idstringdata.date?string (date) | nulldata.titlestringdata.venue?string | nulldata.labels?string[]data.onlinebooleandata.address?string | nulldata.is_free?boolean | nulldata.timezone?string | nulldata.date_label?string | nulldata.price_text?string | nulldata.start_time?string | nulldata.description?string | nulldata.calendar_url?string | nulldata.participants?string[]data.price_amount?number | nulldata.canonical_urlstringdata.schedule_text?string | nulldata.source_region?string | nulldata.registration_url?string | nulltransport?string, default: curl_cffi_residentialrequest_idstringFields marked ? are optional.
GETRegions/v1/regions
Returns the source-native regional and online listing surfaces supported by this API.
Input
No input parameters.
Response
dataobject[]data[].idstringdata[].namestringdata[].onlinebooleandata[].listing_urlstringrequest_idstringDon’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.