Catalog / Gary's Guide Events

Gary's Guide Events API

garysguide.com

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.

  • Business
  • events
  • calendar
  • technology
  • nyc
  • san-francisco
  • online
3 endpointsDocs updated

Endpoint health

Loading verification…

EventsLoading
RegionsLoading

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

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.

Optional parameters 11

Gary's Guide source calendar to read.

Inclusive ISO date lower bound.

Inclusive ISO date upper bound.

Case-insensitive title, venue, address, or description substring.

Case-insensitive venue substring.

When true, return source rows marked Free; when false, return paid rows.

Maximum numeric dollar price; free events are not included unless free=true.

Filter by the source's online calendar surface.

Source-native row label preserved from the calendar image metadata.

Number of records per page.

Opaque cursor from the prior response's next_cursor.

View call pricing
cURL · Events
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) | null

Inclusive ISO date lower bound.

Example: 2026-10-01

date_toOptionalQuery · string (date) | null

Inclusive ISO date upper bound.

Example: 2026-10-31

keywordOptionalQuery · string | null

Case-insensitive title, venue, address, or description substring.

Example: AI

venueOptionalQuery · string | null

Case-insensitive venue substring.

Example: Betaworks

freeOptionalQuery · boolean | null

When true, return source rows marked Free; when false, return paid rows.

Example: true

price_maxOptionalQuery · number, min: 0, max: 100000 | null

Maximum numeric dollar price; free events are not included unless free=true.

Example: 50

onlineOptionalQuery · boolean | null

Filter by the source's online calendar surface.

Example: false

source_labelOptionalQuery · "Popular Event" | "Gary Event" | "Featured Event" | "Sponsored Event" | null

Source-native row label preserved from the calendar image metadata.

Example: Featured Event

limitOptionalQuery · integer, min: 1, max: 100, default: 20

Number of records per page.

Example: 20

cursorOptionalQuery · string | null

Opaque cursor from the prior response's next_cursor.

Response

dataobject[]
data[].idstring
data[].date?string (date) | null
data[].titlestring
data[].venue?string | null
data[].labels?string[]
data[].onlineboolean
data[].address?string | null
data[].is_free?boolean | null
data[].timezone?string | null
data[].date_label?string | null
data[].price_text?string | null
data[].start_time?string | null
data[].description?string | null
data[].calendar_url?string | null
data[].participants?string[]
data[].price_amount?number | null
data[].canonical_urlstring
data[].schedule_text?string | null
data[].source_region?string | null
data[].registration_url?string | null
transport?string, default: curl_cffi_residential
request_idstring
next_cursor?string | null

Fields 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 · string

Lowercase source event token returned by /v1/events.

Example: zfj5xxd

Response

dataobject
data.idstring
data.date?string (date) | null
data.titlestring
data.venue?string | null
data.labels?string[]
data.onlineboolean
data.address?string | null
data.is_free?boolean | null
data.timezone?string | null
data.date_label?string | null
data.price_text?string | null
data.start_time?string | null
data.description?string | null
data.calendar_url?string | null
data.participants?string[]
data.price_amount?number | null
data.canonical_urlstring
data.schedule_text?string | null
data.source_region?string | null
data.registration_url?string | null
transport?string, default: curl_cffi_residential
request_idstring

Fields 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[].idstring
data[].namestring
data[].onlineboolean
data[].listing_urlstring
request_idstring

Don’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.