Extend your community

OpenEvents

GET /2/open_events
  • json
  • xml
Host: api.meetup.com
  • basic
api version 2

Searches for recent and upcoming public events hosted by Meetup groups. Its search window is the past one month through the next three months, and is subject to change. Open Events is optimized to search for current events by location, category, topic, or text, and only lists Meetups that have 3 or more RSVPs. The number or results returned with each request is not guaranteed to be the same as the page size due to secondary filtering. If you're looking for a particular event or events within a particular group, use the standard Events method.

Try it in the console

Request Parameters

At least one of the required parameter(s) must be supplied with the request.

For geo-based requests, you may provide a location in one of three ways. By lat and lon, by zip, or by country, city, and optionally a state, if the provided country has states.

Some groups, while remaining private, still wish to show some information about their events. You can include these events in results using the limited_events request parameter.

and_text
Changes the interpretation of the "text" field from OR'd terms to AND'd terms
category
Return events in the specified category or categories specified by commas. This is the category id returned by the Categories method.
city
A valid city
country
A valid country code
fields
Request that additional fields (separated by commas) be included in the output
lat
A valid latitude, limits the returned group events to those within radius miles
limited_events
Include limited event information for private groups that wish to expose only a small amount of information about their events. This includes just: id, name, utc_offset, time, duration, yes_rsvp_count, waitlist_count, group, visibility, timezone. Value must be true or false.
lon
A valid longitude, limits the returned group events to those within radius miles
radius
Radius, in miles for geographic requests, default 25.0 -- maximum 100. May also be specified as "smart", a dynamic radius based on the number of active groups in the area
state
If searching in a country with states, a valid 2 character state code
status
Status may be "upcoming", "past" or both separated by a comma. The default is "upcoming" only
text
Events that contain the given term or terms somewhere in their content. The terms are OR'd by default. Separate terms with " AND " for events that have combined terms. To have terms automatically AND'd, set the "and_text" to true
text_format
Format of the description text, "html" or "plain". Defaults to "html"
time
Return events scheduled within the given time range, defined by two times separated with a single comma. Each end of the range may be specified with relative dates, such as "1m" for one month from now, or by absolute time in milliseconds since the epoch. If an endpoint is omitted, the range is unbounded on that end. The default value is unbounded on both ends (though restricted to the search window described above). Note: to retrieve past events you must also update status value
topic
Return events in the specified topic or topics specified by commas. This is the topic "urlkey" returned by the Topics method. If all supplied topics are unknown, a 400 error response is returned with the code "badtopic".
zip
A valid US zip code, limits the returned groups to those within radius miles

Ordering

distance
ordering is approximate and will not exactly match the values in the "distance" field.
time
(default order) ascending
trending
you will likely want to specify "desc=true" to get the best trending results first.

Response

announced
Organizers and hosts can see if the event was announced
announced_at
Organizers and hosts can see when the event as announced in milliseconds since the epoch
comment_count
Returned when fields request parameter contains "comment_count" and represents number of comments posted to the event
created
UTC creation time of the event, in milliseconds since the epoch
description
Description of the event.
distance
Distance in miles from the search location, if one was specified
duration
Event duration in milliseconds, if an end time is specified by the organizer. When not present, a default of 3 hours may be assumed by applications.
email_reminders
Returned when fields request parameter contains "email_reminders" and is limited to organizers and event hosts, if false, event reminders are disabled
event_hosts
List of members hosting the event, only returned if requested in the fields parameter.
member_id
The host's member id
member_name
The host's member name
event_url
URL of the event's page on meetup.com
featured
Returned when fields request parameter contains "featured" and returns "true" if the event is featured and "false" otherwise
fee
Fee info returned when payment is defined
accepts
Accepted method of payment. Can be one of "paypal", "amazon", or "cash"
amount
Amount of the fee
currency
Currency accepted for fee
description
Fee description, typically "per person"
label
Fee label, typically "Price"
required
"1" if payment is required to RSVP, "0" otherwise
group
Group that is hosting the event
approved
Returned when fields request parameter contains "group_approved". True if this group has been approved. New groups are generally approved (or removed) soon after creation.
category
Optional field. Category of this group
id
Numeric identifier of the category
name
Display name of the category
shortname
String identifier of the category
created
Date and time that the group was founded, in milliseconds since the epoch
group_lat
Approximate group latitude
group_lon
Approximate group longitude
group_photo
Returned when fields request parameter contains "group_photo" and represents photo for the group hosting the event
highres_link
URL for the photo at its maximum size
photo_id
-
photo_link
URL for a standard size of the photo
thumb_link
URL for a thumbnail of the photo
id
Group id
join_mode
"open", "approval", or "closed"
membership_dues
Returned when fields request parameter contains "group_membership_dues"
currency
Currency fee is declared as
fee
Numeric fee value
fee_desc
Description of fee
methods
Array of acceptable payment methods. May be one or more of "amazon_payments", "paypal", "credit_card" or "other"
reasons
Array of reasons types in the following values compensate_organizer, cover_costs, encourage_engagement, improve_meetups, other, provide_supplies, reserve_fund
reasons_other
An additional reason if specified.
refund_policy
Array of payment refund policies. May be one or more of "none", "member_leaves", "group_closes", "member_banned", or "custom"
required
"2" if dues are required to join, "1" if dues are required to RSVP, "0" otherwise
self_payment_required
Returns true if the authorized user is prevented from participating in the group until a payment is made
trial_days
When present, returns the number of days the group is offering a free trial period for to new members. When not present, this indicates that the group does not offer a trial membership period
name
Group name
self
Returned when fields request parameter contains 'self_membership_dues' or 'group_status'
membership_dues
The authenticated member's group dues in the form returned by group endpoints
status
The member's status. May be one of 'active' or 'pending'
topics
Optional field. Topics related to this group
id
Topic ID
name
Topic name
urlkey
Unique keyword used to identify this topic
urlname
Group URL name
who
What the group calls its members
headcount
The number of members in attendance according to the attendance taker. This may be 0 if attendance has not yet been taken
how_to_find_us
The information provided by the event host for "How will members find you there?". Visible when location is visible to the authenticated member
id
The event id. May be numeric or alphanumeric, always served as a string
is_simplehtml
Optional field, "true" when the event has been saved in a simplified HTML format, "false" otherwise.
maybe_rsvp_count
Number of maybe RSVPs including guests
name
The name of the event
photo_album_id
Returned when fields request parameter contains "photo_album_id" and returns the ID of the photo album for this event, if one exists
photo_count
Returned when fields request parameter contains "photo_count" and represents number of photos posted to the event
photo_url
URL of the event photo, if one exists
publish_status
"published" or "draft" only visible to organizers
rating
Only past events have this field, an aggregate of anonymous ratings
average
Average of collected ratings
count
Number of ratings been collected
rsvp_alerts
Returned when fields request parameter contains "rsvp_alerts" and is limited to organizers and event hosts, if false, member RSVP alerts are disabled
rsvp_limit
The number of "yes" RSVPs an event can have before members will be added to the waiting list
rsvp_rules
Conditions set by the organizer, only returned if requested in the fields parameter.
close_time
UTC time that RSVPs will no longer be accepted, though organizers may close RSVPs earlier
closed
Flag indicating that RSVPing is closed for the event. 1 is true 0 is false
guest_limit
Number of guests members may include in their RSVP, 0 or more
open_time
UTC time that members may begin to RSVP
refund_policy
The organizer-defined terms for refunds. If this is defined, you must provide the authenticated member a way to access this information before they can RSVP. They will need to agree to these terms before they RSVP
days
if member_cancellation is present, it's relative to this many days before the event
notes
additional refund policy notes
policies
list of one or more of the following. 'no_refunds' if the organizer will not issue refunds', 'member_cancellation' if the organizer offers a refund for member cancellation, 'event_cancellation' if the organizer offers a refund if the event is canceled, 'event_rescheduled' if the organizer offers a refund when the event is rescheduled
waitlisting
Wait list handling when RSVP limit is reached. Value may be one of "auto", "manual" or "off"
rsvpable
Indicates if the currently authenticated member can RSVP or not, only returned if requested in the fields parameter
self
Returned when fields request parameter contains "self" and represents details particular to the authorized user, only present if requested and user is a member of the hosting group
actions
list of actions the current user may perform, potentially: "announce" to announce the event to the group's members, "attendance" to view or take attendance for the event, "payments" to mark members as paid if the event is a paid event, "publish" to publish a draft event, "edit" to edit the event information, "edit_hosts" to edit the hosts for the event, "delete" to delete the event, "rsvp" to RSVP yes or no to the event, or "wait" to get on the waiting list (using the same RSVP methods). For events without a waitlist, you may see either "watch" or "unwatch" to watch for opening spots for the event when the event is full. If an organizer requires membership dues to rsvp and the authorized member has not paid theirs, "dues" will be included
pay_status
The authenticated member's payment status. This may be one of 'none', 'paid', 'partially_paid', 'payment_pending', 'echeck_pending', 'refund_pending', 'partially_refunded', 'refunded'.
rated
Boolean indicator of whether the current member rated the event or not
role
The authenticated member's role in within the group, if any. This may be one of: Organizer, Assistant Organizer, Event Organizer, etc.
rsvp
Member's RSVP, if any
answers
List of answers to event survey questions asked when the member RSVP'd in the order asked, only available to organizers and assistant organizers. By default, this field returns a list of strings answers. You can request more structured answer info including the time the answer was updated, by setting fields=rsvp_answer_info in the request. The structured format for answers is defined in Rsvp API's response
guests
number of guests
response
"yes", "no", or "waitlist"
watching
For events without waitlist you may check your watchlist status with this property. Values may either be true of false.
short_link
Returned when fields request parameter contains "short_link". If hosting group is private, this will return the group's short_link
simple_html_description
Optional field, description of the event in simple HTML format.
status
"cancelled", "upcoming", "past", "proposed", "suggested" or "draft"
survey_questions
Returned when fields request parameter contains "survey_questions" for events with surveys
id
Question identifier
question
Question text
required
Flag indicating if a response to this question is required to RSVP. Currently always false.
time
UTC start time of the event, in milliseconds since the epoch
timezone
Returned when fields request parameter contains "timezone". This represents the universal timezone identifier for the host group
trending_rank
Indicates the trending rank within the current result set. The best rank is zero, increasing rank values are less "trending". This value is only returned if requested in the fields parameter
updated
UTC last modified time of the event, in milliseconds since the epoch
utc_offset
The local offset from UTC time, in milliseconds
venue
Venue, if selected and not hidden
address_1
Line 1 of venue address
address_2
Line 2 of venue address
address_3
Line 3 of venue address
city, state, country
City, Country and if in US state of venue
id
Venue id
lat, lon
Geographic coordinates of venue
name
Venue name
phone
Phone number of venue
repinned
true if the editor of the event altered the original venues pin location, false otherwise
zip
ZIP code if, venue is in US or Canada
venue_visibility
Set to "members" or "public". The "venue" element will not be present if the visibility is "members" and the current authenticated user is not a member of the group hosting the event. This value is only returned if requested in the fields parameter
visibility
Event visibility: "public", "members" or "public_limited". Events in private groups that do not expose limited information are visible only to that group's members and should not be made public.
why
We should do this because...
yes_rsvp_count
Number of yes RSVPs including guests

Examples

Photography Meetups happening within the next week. The time range is unbounded on the left but status defaults to "upcoming":

https://api.meetup.com/2/open_events.xml?topic=photo&time=,1w&key=ABDE12456AB2324445

Meetups around New York within the past week. The time range is unbounded on the right:

https://api.meetup.com/2/open_events.xml?zip=10012&time=-1w,&status=past&key=ABDE12456AB2324445

Meetups mentioning racquetball in the past or next week:

https://api.meetup.com/2/open_events.xml?text=racquetball&time=-1w,1w&status=past,upcoming&key=ABDE12456AB2324445

API methods