Search Meetup events

Try in Playground

Search public events by keyword, location, category, distance, date range and attendance format, with ordered results and cursor pagination.

GET/v1/meetup/searchx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

querystringrequiredquery

Required keyword query, 1–200 characters.

min 1 chars · max 200 chars

Exampletechnology

locationstringrequiredquery

Meetup location slug returned by Locations, such as gb--london or us--ny--new-york.

max 200 chars

Examplegb--london

category_idstringquery

Category identifier returned by Categories.

distanceenumquery

Source distance preset: twoMiles, fiveMiles, tenMiles, twentyFiveMiles, fiftyMiles, hundredMiles or anyDistance. Meetup interprets presets using the location and locale.

one of: twoMiles, fiveMiles, tenMiles, twentyFiveMiles, fiftyMiles, hundredMiles, anyDistance

cursorstringquery

Pass nextCursor with the same request parameters to retrieve the next page.

min 1 chars · max 8192 chars

start_datestringquery

ISO 8601 start date-time, supplied together with end_date.

end_datestringquery

ISO 8601 end date-time, equal to or after start_date.

event_typeenumquery

online or inPerson.

one of: online, inPerson

sortenumquery

RELEVANCE or DATETIME.

one of: RELEVANCE, DATETIME

Response fields

157

requestIdstring

Request correlation UUID.

Upstream HTTP attempts, decoded response bytes and duration in milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data is returned.

statusenum

success, partial, failed or challenged; HTTP 200 may be partial.

one of: success, partial

sourceUrlstring

Canonical public Meetup page retrieved.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Source coverage metadata and warnings associated with the result.

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

Ordered event summaries: IDs, titles, dates, descriptions, photos, venue, group, fee settings, RSVP totals and recurrence fields when supplied. Call event for expanded details.

up to 100 items

events.idstring

Always included.

events.groupJSONoptional

Optional.

events.groupPhotoJSONoptional

Optional.

events.identifierJSONoptional

Optional.

events.serviceJSONoptional

Optional.

events.rsvpCountJSONoptional

Optional.

events.groupCountJSONoptional

Optional.

events.googleMapsUrlJSONoptional

Optional.

events.isFeaturedJSONoptional

Optional.

events.masksJSONoptional

Optional.

events.vaccinationsJSONoptional

Optional.

events.detailsJSONoptional

Optional.

events.venueTypeJSONoptional

Optional.

events.isNewGroupJSONoptional

Optional.

events.weeklyRecurrenceJSONoptional

Optional.

events.monthlyRecurrenceJSONoptional

Optional.

events.monthlyDayOfWeekJSONoptional

Optional.

events.monthlyWeekOfMonthJSONoptional

Optional.

events.weeklyDaysOfWeekJSONoptional

Optional.

events.weeklyIntervalJSONoptional

Optional.

events.namestringnullableoptional

Optional.

events.titlestring

Always included.

events.urlnameJSONoptional

Optional.

events.descriptionstringnullableoptional

Optional.

events.timezoneJSONoptional

Optional.

events.keyGroupPhotoJSONoptional

Optional.

events.isPrivatebooleannullableoptional

Optional.

events.organizerJSONoptional

Optional.

events.stats.memberCounts.allintegernullableoptional

Optional.

events.stats.memberCounts.leadershipintegernullableoptional

Optional.

events.stats.eventRatings.averagenumbernullableoptional

Optional.

events.stats.eventRatings.totalRatingsintegernullableoptional

Optional.

events.stats.eventRatings.totalintegernullableoptional

Optional.

events.latnumbernullableoptional

Optional.

events.lonnumbernullableoptional

Optional.

events.joinModeJSONoptional

Optional.

events.statusJSONoptional

Optional.

events.citystringnullableoptional

Optional.

events.statestringnullableoptional

Optional.

events.countrystringnullableoptional

Optional.

events.proNetworkJSONoptional

Optional.

events.welcomeBlurbJSONoptional

Optional.

events.organizerStartTimeJSONoptional

Optional.

events.videoJSONoptional

Optional.

events.featuredEventJSONoptional

Optional.

events.activeTopicsJSONoptional

Optional.

events.topicCategoryJSONoptional

Optional.

events.sponsorsJSONoptional

Optional.

events.foundedDateJSONoptional

Optional.

events.socialNetworksJSONoptional

Optional.

events.eventUrlJSONoptional

Optional.

events.creatorMemberJSONoptional

Optional.

events.eventHostsJSONoptional

Optional.

events.feeSettingsJSONoptional

Optional.

events.venueJSONoptional

Optional.

events.dateTimestringnullableoptional

Optional.

events.createdTimeJSONoptional

Optional.

events.endTimestringnullableoptional

Optional.

events.goingJSONoptional

Optional.

events.isOnlineJSONoptional

Optional.

events.eventTypestringnullableoptional

Optional.

events.seriesJSONoptional

Optional.

events.featuredEventPhotoJSONoptional

Optional.

events.displayPhotoJSONoptional

Optional.

events.maxTicketsintegernullableoptional

Optional.

events.rsvpSettingsJSONoptional

Optional.

events.isNetworkEventJSONoptional

Optional.

events.networkEventJSONoptional

Optional.

events.socialLabelsJSONoptional

Optional.

events.socialProofInsightsJSONoptional

Optional.

events.waitlistModeJSONoptional

Optional.

events.guestsAllowedJSONoptional

Optional.

events.numberOfAllowedGuestsJSONoptional

Optional.

events.topicsJSONoptional

Optional.

events.covidPrecautionsJSONoptional

Optional.

events.speakerDetailsJSONoptional

Optional.

events.komootUrlJSONoptional

Optional.

events.memberIdJSONoptional

Optional.

events.memberJSONoptional

Optional.

events.memberPhotoJSONoptional

Optional.

events.isSuperOrganizerJSONoptional

Optional.

events.highResUrlJSONoptional

Optional.

events.baseUrlJSONoptional

Optional.

events.linkJSONoptional

Optional.

events.logoJSONoptional

Optional.

events.groupsJSONoptional

Optional.

events.addressJSONoptional

Optional.

events.address1JSONoptional

Optional.

events.address2JSONoptional

Optional.

events.zipJSONoptional

Optional.

events.postalCodeJSONoptional

Optional.

events.venueNameJSONoptional

Optional.

events.lngJSONoptional

Optional.

events.radiusJSONoptional

Optional.

events.localizedCountryNameJSONoptional

Optional.

events.urlJSONoptional

Optional.

events.urlkeyJSONoptional

Optional.

events.typeJSONoptional

Optional.

events.valueJSONoptional

Optional.

events.amountJSONoptional

Optional.

events.currencyJSONoptional

Optional.

events.feeJSONoptional

Optional.

events.requiredJSONoptional

Optional.

events.acceptsJSONoptional

Optional.

events.priceJSONoptional

Optional.

events.labelJSONoptional

Optional.

events.isRefundableJSONoptional

Optional.

events.refundPolicyJSONoptional

Optional.

events.memberCountsJSONoptional

Optional.

events.allJSONoptional

Optional.

events.leadershipJSONoptional

Optional.

events.eventRatingsJSONoptional

Optional.

events.averageJSONoptional

Optional.

events.totalJSONoptional

Optional.

events.totalRatingsJSONoptional

Optional.

events.totalCountintegernullableoptional

Optional.

events.edgesJSONoptional

Optional.

events.nodeJSONoptional

Optional.

events.pageInfoJSONoptional

Optional.

events.hasNextPageJSONoptional

Optional.

events.rsvpsJSONoptional

Optional.

events.rsvpsClosedJSONoptional

Optional.

events.rsvpOpenTimeJSONoptional

Optional.

events.rsvpCloseTimeJSONoptional

Optional.

events.isTrendingEventJSONoptional

Optional.

events.totalInterestedUsersJSONoptional

Optional.

events.interestedUsersSampleJSONoptional

Optional.

events.photoJSONoptional

Optional.

events.sourceJSONoptional

Optional.

events.attributionJSONoptional

Optional.

events.widthJSONoptional

Optional.

events.heightJSONoptional

Optional.

events.upcomingEventsJSONoptional

Optional.

events.pastEventsJSONoptional

Optional.

events.attendeesJSONoptional

Optional.

events.waitlistJSONoptional

Optional.

events.attendeePreviewJSONoptional

Optional.

totalCountintegernullable

Source count of matching results, or null when absent.

hasNextPagebooleannullable

Whether the source reports more matching results.

nextCursorstringnullable

Continuation token for the next page, or null.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable page data with explicit coverage warnings.
400	`invalid_request`	Missing, duplicate, unsupported or malformed parameters.
401	`unauthorized`	Missing or invalid service key.
403	`restricted`	Private group or restricted parent group.
404	`not_found`	Missing resource.
429	`upstream_rate_limited`	Source throttled retrieval.
502	`upstream_challenged`	Source challenged logged-out access.
502	`unsupported_page`	Missing, malformed or mismatched structured data.
502	`response_too_large` `payload_too_complex`	Byte, node or depth limit exceeded.
502	`unsafe_redirect` `request_limit` `upstream_error`	Bounded retrieval failed.
503	`busy`	All slots are occupied.
504	`timeout`	Deadline expired.
404	`member_not_on_page`	Member was not found in the supported public records on this page; account existence is unknown.

Code example

curl "https://api.scrapeatlas.com/v1/meetup/search?query=technology&location=gb--london" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/meetup/search?query=technology&location=gb--london",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/meetup/search?query=technology&location=gb--london",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Meetup request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/meetup/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "query": "technology",
        "location": "gb--london"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/meetup/search?query=technology&location=gb--london", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/meetup/search?query=technology&location=gb--london"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.meetup.com/find/?keywords=technology&source=EVENTS&location=gb--london",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 120000,
    "durationMs": 500
  },
  "events": [
    {
      "id": "123",
      "title": "Example technology meetup",
      "description": null
    }
  ],
  "totalCount": 25,
  "hasNextPage": false,
  "nextCursor": null
}

Missing, duplicate, unsupported or malformed parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}