# Meetup API: Search events

> Finds upcoming public Meetup events by topic and city, sorted by start time. Only events that mention the topic are included; external costs and undisclosed venues may not be shown.

Unofficial. Not affiliated with or endorsed by Meetup.

- Page: https://fous.com/methods/meetup.com/search-events
- Method: `meetup.com/search_events`, version 1
- Website: meetup.com
- Returns: title, group, start time, type, venue, attendees, fee, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `city` | string | yes | `"Austin, TX"` | City and region to search, such as Austin, TX. |
| `topic` | string | yes | `"hiking"` | Event topic, such as Python or hiking. |
| `end_date` | string | no | `"2026-11-30"` | Last event date, YYYY-MM-DD; defaults to 30 days from today. |
| `event_type` | string | no | `"in_person"` | Find any, in-person, or online events. One of "any", "in_person", "online". Default "any". |
| `start_date` | string | no | `"2026-11-01"` | First event date, YYYY-MM-DD; defaults to today. |
| `max_results` | integer | no | `10` | Maximum number of events returned, up to 100. Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "city": "Austin, TX",
  "topic": "hiking",
  "end_date": "2026-11-30",
  "event_type": "in_person",
  "start_date": "2026-11-01",
  "max_results": 10
}
```

Its output:

```json
{
  "events": [
    {
      "fee": null,
      "title": "Turkey Creek Hike and Guided meditation",
      "is_free": true,
      "currency": null,
      "event_id": "316734452",
      "group_id": "38696206",
      "event_link": "https://www.meetup.com/innergrising-austin/events/316734452/",
      "event_type": "in_person",
      "group_name": "innerGrising Austin",
      "venue_name": "Turkey Creek Trailhead",
      "venue_address": "1401-1711 City Park Rd, Austin, TX 78730, USA",
      "start_datetime": "2026-09-29T08:30:00-05:00",
      "attendees_going": 2
    },
    {
      "fee": null,
      "title": "Wednesday Hikes in the Upper Barton Creek Greenbelt (Starting at 9:00 AM!)",
      "is_free": true,
      "currency": null,
      "event_id": "315450713",
      "group_id": "31895211",
      "event_link": "https://www.meetup.com/primetimeatx/events/315450713/",
      "event_type": "in_person",
      "group_name": "PrimeTime ATX",
      "venue_name": "5216 Magdelena Dr",
      "venue_address": "5216 Magdelena Dr, Austin, TX",
      "start_datetime": "2026-09-30T09:00:00-05:00",
      "attendees_going": 4
    },
    {
      "fee": null,
      "title": "Hike River Place starting at Little Fern Trailhead ",
      "is_free": true,
      "currency": null,
      "event_id": "316753438",
      "group_id": "36806723",
      "event_link": "https://www.meetup.com/river-place-wednesday-morning-meetup-group/events/316753438/",
      "event_type": "in_person",
      "group_name": "River Place Hiking Meetup Group",
      "venue_name": null,
      "venue_address": null,
      "start_datetime": "2026-10-02T08:45:00-05:00",
      "attendees_going": 2
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"meetup.com/search_events","input":{"city":"Austin, TX","topic":"hiking","end_date":"2026-11-30","event_type":"in_person","start_date":"2026-11-01","max_results":10}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find upcoming Python meetups in Austin, TX over the next month, with venue and attendee count for each
- Any in-person hiking group events in Denver, CO between 2026-10-03 and 2026-10-18? Show me the fee and who's hosting.
- What's on meetup.com for board games in Chicago, IL this coming weekend? Just list the top 10 by start time.
- I'm visiting Seattle, WA from November 12 to 16, 2026 — are there any photography walks or meetups I could join in person?
- Search meetup.com for online machine learning events tied to Boston, MA through the end of December 2026, up to 50 results with links.

## Input schema

```json
{
  "type": "object",
  "required": [
    "topic",
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "examples": [
        "Austin, TX"
      ],
      "description": "City and region to search, such as Austin, TX."
    },
    "topic": {
      "type": "string",
      "examples": [
        "Python"
      ],
      "description": "Event topic, such as Python or hiking."
    },
    "end_date": {
      "type": "string",
      "examples": [
        "2026-10-29"
      ],
      "description": "Last event date, YYYY-MM-DD; defaults to 30 days from today."
    },
    "event_type": {
      "enum": [
        "any",
        "in_person",
        "online"
      ],
      "type": "string",
      "default": "any",
      "examples": [
        "in_person"
      ],
      "description": "Find any, in-person, or online events."
    },
    "start_date": {
      "type": "string",
      "examples": [
        "2026-09-29"
      ],
      "description": "First event date, YYYY-MM-DD; defaults to today."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum number of events returned, up to 100."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "events"
  ],
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "group_name",
          "start_datetime",
          "event_type",
          "venue_name",
          "venue_address",
          "attendees_going",
          "is_free",
          "fee",
          "currency",
          "event_link",
          "event_id",
          "group_id"
        ],
        "properties": {
          "fee": {
            "type": [
              "number",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_free": {
            "type": "boolean"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "event_id": {
            "type": "string",
            "x-fous-developer": true
          },
          "group_id": {
            "type": [
              "string",
              "null"
            ],
            "x-fous-developer": true
          },
          "event_link": {
            "type": "string"
          },
          "event_type": {
            "enum": [
              "in_person",
              "online"
            ],
            "type": "string"
          },
          "group_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "venue_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "venue_address": {
            "type": [
              "string",
              "null"
            ]
          },
          "start_datetime": {
            "type": "string",
            "description": "Event start time with local offset."
          },
          "attendees_going": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Eventbrite API: Search events](https://fous.com/methods/eventbrite.com/search-events.md): Finds public Eventbrite events in a city or online, with optional keywords, date range, category and free-only filtering, ordered by start time.
- [Songkick API: Search concerts in a city](https://fous.com/methods/songkick.com/search-concerts.md): Finds upcoming concerts in a city between two dates on Songkick. Each concert includes its artists, venue, festival name and ticket link.
- [Ticketmaster API: Search events](https://fous.com/methods/ticketmaster.com/search-events.md): Finds upcoming Ticketmaster-listed concerts, sports, theater and other events by keyword, optionally by city, country, category and date range, with dates, venues, prices when shown and links. Partner-only listings without a Ticketmaster link are excluded; very large searches cover only the first 800 listings.
- [OfferUp API: Search listings](https://fous.com/methods/offerup.com/search-listings.md): Finds OfferUp items for sale near a US city or ZIP code, with prices, condition, seller names, distance and links. Distances use approximate listing locations.
- [Udemy API: Search courses by topic](https://fous.com/methods/udemy.com/search-courses.md): Searches Udemy courses on a topic and returns US visitor prices in USD, ratings, lecture counts and course details.
- [Substack API: Search newsletters](https://fous.com/methods/substack.com/search-newsletters.md): Finds public Substack newsletters matching a topic, in Substack's search order. Subscriber counts are null when Substack does not display one.
- [Craigslist API: Search listings](https://fous.com/methods/craigslist.org/search-listings.md): Searches public Craigslist listings in a city or area, newest first. Renewed listings may have older original posting dates.
- [UFC API: List events](https://fous.com/methods/ufc.com/list-events.md): Lists upcoming or past UFC events with fight cards, venue, start time and completed bout results, or returns one event by name. Upcoming events come soonest first and past events newest first.