---
title: "Search Meetup events"
method: GET
path: "/v1/meetup/search"
tags: ["Meetup"]
---

# Search Meetup events

`GET /v1/meetup/search`

## Request

- Base URL: `https://api.scrapeatlas.com`
- URL: `https://api.scrapeatlas.com/v1/meetup/search`
- Auth: API key in header `x-api-key`

Search public events by keyword, location, category, distance, date range and attendance format, with ordered results and cursor pagination. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

## Query parameters

- `query` string, required
- `location` string, required
- `category_id` string
- `distance` 'twoMiles' | 'fiveMiles' | 'tenMiles' | 'twentyFiveMiles' | 'fiftyMiles' | 'hundredMiles' | 'anyDistance'
- `cursor` string
- `start_date` string, date-time
- `end_date` string, date-time
- `event_type` 'online' | 'inPerson'
- `sort` 'RELEVANCE' | 'DATETIME'

## Response `200`

Inspect the response status and failure or coverage fields.

- union
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` true, required
    - `status` 'success' | 'partial', required
    - `sourceUrl` string, uri, required
    - `fetchedAt` string, date-time, required
    - `coverage` object, required
      - `source` 'public_page', required
      - `complete` boolean, required
      - `warnings` string[], required
    - `events` object[], required
      - `id` string, required
      - `group` unknown
      - `groupPhoto` unknown
      - `identifier` unknown
      - `service` unknown
      - `rsvpCount` unknown
      - `groupCount` unknown
      - `googleMapsUrl` unknown
      - `isFeatured` unknown
      - `masks` unknown
      - `vaccinations` unknown
      - `details` unknown
      - `venueType` unknown
      - `isNewGroup` unknown
      - `weeklyRecurrence` unknown
      - `monthlyRecurrence` unknown
      - `monthlyDayOfWeek` unknown
      - `monthlyWeekOfMonth` unknown
      - `weeklyDaysOfWeek` unknown
      - `weeklyInterval` unknown
      - `name` string, nullable
      - `title` string, required
      - `urlname` unknown
      - `description` string, nullable
      - `timezone` unknown
      - `keyGroupPhoto` unknown
      - `isPrivate` boolean, nullable
      - `organizer` unknown
      - `stats` object, nullable
        - `memberCounts` object, nullable
          - `all` integer, nullable
          - `leadership` integer, nullable
        - `eventRatings` object, nullable
          - `average` number, nullable
          - `totalRatings` integer, nullable
          - `total` integer, nullable
      - `lat` number, nullable
      - `lon` number, nullable
      - `joinMode` unknown
      - `status` unknown
      - `city` string, nullable
      - `state` string, nullable
      - `country` string, nullable
      - `proNetwork` unknown
      - `welcomeBlurb` unknown
      - `organizerStartTime` unknown
      - `video` unknown
      - `featuredEvent` unknown
      - `activeTopics` unknown
      - `topicCategory` unknown
      - `sponsors` unknown
      - `foundedDate` unknown
      - `socialNetworks` unknown
      - `eventUrl` unknown
      - `creatorMember` unknown
      - `eventHosts` unknown
      - `feeSettings` unknown
      - `venue` unknown
      - `dateTime` string, nullable
      - `createdTime` unknown
      - `endTime` string, nullable
      - `going` unknown
      - `isOnline` unknown
      - `eventType` string, nullable
      - `series` unknown
      - `featuredEventPhoto` unknown
      - `displayPhoto` unknown
      - `maxTickets` integer, nullable
      - `rsvpSettings` unknown
      - `isNetworkEvent` unknown
      - `networkEvent` unknown
      - `socialLabels` unknown
      - `socialProofInsights` unknown
      - `waitlistMode` unknown
      - `guestsAllowed` unknown
      - `numberOfAllowedGuests` unknown
      - `topics` unknown
      - `covidPrecautions` unknown
      - `speakerDetails` unknown
      - `komootUrl` unknown
      - `memberId` unknown
      - `member` unknown
      - `memberPhoto` unknown
      - `isSuperOrganizer` unknown
      - `highResUrl` unknown
      - `baseUrl` unknown
      - `link` unknown
      - `logo` unknown
      - `groups` unknown
      - `address` unknown
      - `address1` unknown
      - `address2` unknown
      - `zip` unknown
      - `postalCode` unknown
      - `venueName` unknown
      - `lng` unknown
      - `radius` unknown
      - `localizedCountryName` unknown
      - `url` unknown
      - `urlkey` unknown
      - `type` unknown
      - `value` unknown
      - `amount` unknown
      - `currency` unknown
      - `fee` unknown
      - `required` unknown
      - `accepts` unknown
      - `price` unknown
      - `label` unknown
      - `isRefundable` unknown
      - `refundPolicy` unknown
      - `memberCounts` unknown
      - `all` unknown
      - `leadership` unknown
      - `eventRatings` unknown
      - `average` unknown
      - `total` unknown
      - `totalRatings` unknown
      - `totalCount` integer, nullable
      - `edges` unknown
      - `node` unknown
      - `pageInfo` unknown
      - `hasNextPage` unknown
      - `rsvps` unknown
      - `rsvpsClosed` unknown
      - `rsvpOpenTime` unknown
      - `rsvpCloseTime` unknown
      - `isTrendingEvent` unknown
      - `totalInterestedUsers` unknown
      - `interestedUsersSample` unknown
      - `photo` unknown
      - `source` unknown
      - `attribution` unknown
      - `width` unknown
      - `height` unknown
      - `upcomingEvents` unknown
      - `pastEvents` unknown
      - `attendees` unknown
      - `waitlist` unknown
      - `attendeePreview` unknown
    - `totalCount` integer, nullable, required
    - `hasNextPage` boolean, nullable, required
    - `nextCursor` string, nullable, required
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` false, required
    - `status` 'failed' | 'challenged', required
    - `failure` object, required
      - `code` 'member_not_on_page' | 'restricted' | 'invalid_request' | 'unauthorized' | 'not_found' | 'upstream_challenged' | 'upstream_rate_limited' | 'upstream_error' | 'unsupported_page' | 'response_too_large' | 'unsafe_redirect' | 'request_limit' | 'timeout' | 'busy' | 'payload_too_complex', required
      - `message` string, required

## Other responses

- `400`: Request could not complete; inspect error or failure.code.
- `401`: Request could not complete; inspect error or failure.code.
- `402`: Request could not complete; inspect error or failure.code.
- `403`: Request could not complete; inspect error or failure.code.
- `404`: Request could not complete; inspect error or failure.code.
- `408`: Request could not complete; inspect error or failure.code.
- `413`: Request could not complete; inspect error or failure.code.
- `429`: Request could not complete; inspect error or failure.code.
- `500`: Request could not complete; inspect error or failure.code.
- `502`: Request could not complete; inspect error or failure.code.
- `503`: Request could not complete; inspect error or failure.code.
- `504`: Request could not complete; inspect error or failure.code.

---

[API](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api.md) · [All operations](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/revisions/9ba049316894?raw)