addressalign-toparrow-leftarrow-rightbackbellblockcalendarcameraccwcheckchevron-downchevron-leftchevron-rightchevron-small-downchevron-small-leftchevron-small-rightchevron-small-upchevron-upcircle-with-checkcircle-with-crosscircle-with-pluscrossdots-three-verticaleditemptyheartexporteye-with-lineeyefacebookfolderfullheartglobegmailgooglegroupshelp-with-circleimageimagesinstagramlinklocation-pinm-swarmSearchmailmessagesminusmoremuplabelShape 3 + Rectangle 1ShapeoutlookpersonJoin Group on CardStartprice-ribbonShapeShapeShapeShapeImported LayersImported LayersImported Layersshieldstartickettrashtriangle-downtriangle-uptwitteruserwarningyahoo

Extend your community

Recommended Events

GET /recommended/events
  • json
Host: api.meetup.com
  • basic
api version 3

Returns a list of upcoming recommended events

Try it in the console

Request Parameters

By default, the events returned will be based on the hosting groups near the authenticated member's location. To customize this location, send a valid "lat" and "lon" parameter combination reflecting a desired location.

You may filter results using an topic category identifier from the Topic Categories API

This endpoint uses HTTP Link header based pagination. Results may page forward but never in reverse

fields

A comma-delimited list of optional fields to populate in the response

lat

Approximate target latitude

lon

Approximate target longitude

page

A target minimum number of events to return in a single page of results. The number returned is non-deterministic but a best-effort attempt will be made to return at least some. Defaults to 32

self_groups

Boolean indicator of whether or not to include events within your existing Meetup network. This includes groups in locations that may differ from the target location. Defaults to true

topic_category

Numeric topic category identifier for filtering recommendations by a topic category

Response

Returns a list of event objects

comment_count

An aggregate count of all comments and replies for a given event, returned when fields request parameter value includes 'comment_count'

created

Creation time of the event, in milliseconds since the epoch

description

Description of the event in HTML. Email addresses and phone numbers will be masked for non-members

duration

Scheduled 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

event_hosts

List of members hosting the event, returned when fields request parameter value includes 'event_hosts'

id

Host member's id

name

Host member's name

photo

Member photo if one exists

base_url

A base url that can be use to construct a photo url from its components

highres_link

Link for full sized photo

id

Numeric photo ID

photo_link

Link for standard sized photo

thumb_link

Link for thumbnail sized photo

type

Type of photo. One of "event" or "member"

featured

Boolean indicator of whether or not a given event is featured, returned when fields request parameter value includes 'featured'

fee

Ticketing fee information for events that support payments

accepts

Acceptable methods of payments may be one of "paypal", "amazon", "wepay", or "cash"

amount

Amount of the fee

currency

Currency accepted for fee

description

Fee description, typically "per-person"

label

Label for fee, typically "Price"

required

Boolean flag indicating if this fee is required to RSVP

group

Information about group hosting the event

category

Category group belongs to, returned when fields request parameter value includes 'group_category'

id

Numeric category id

name

Display name of the category

shortname

String identifier of the category

sort_name

Name used for sorting

id

Numeric identifier for the group

join_info

Lists any questions requested when joining and required fields. Returned with "fields" request parameter value includes "group_join_info"

photo_req

true if required, false otherwise

questions

List of profile questions organizer would like new members to answer prior to joining

questions_req

true if required, false otherwise

join_mode

Indicator of how new members may be able to join. be one of "open", "approval" or "closed"

lat

Approximate group latitude

lon

Approximate group longitude

membership_dues

Membership dues information associated with hosting group, returned when fields request parameter value includes 'group_membership_dues'

currency

Currency in which the fee is declared

fee

Numeric fee value

fee_desc

The interval at which dues must be paid. Possible values may include: "month", "year", "day", or "every other day"

methods

Methods of payments

reasons

Array of reasons containing one or more of 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

Conditions for refunds

required

true if dues are required

required_to

If the dues are required this indicates what they are required for. May be one of 'join' or 'rsvp'

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

Name of the group

photo

Photo associated with group, returned when fields request parameter value includes 'group_photo'

base_url

A base url that can be use to construct a photo url from its components

highres_link

Link for full sized photo

id

Numeric photo ID

photo_link

Link for standard sized photo

thumb_link

Link for thumbnail sized photo

type

Type of photo. One of "event" or "member"

self

Information pertaining to the authenticated member with respect to the group, returned when fields request parameter value includes 'group_self_actions', 'group_self_membership_dues', or 'group_self_status'

actions

list of actions the authenticated member may perform, potentially "event_create": the ability to create new events, "event_draft": the ability to save new events as drafts, "role_assign": the ability to assign member roles, "edit": the ability to edit group settings, "member_approval": the ability to approve or decline member requests to join, or "subscription_upgrade": the ability to upgrade this group's subscription plan

membership_dues

Membership dues information associated with hosting group, returned when "fields" request parameter value includes "group_membership_dues" and group has dues

status

Indicates the authorized user's membership with this group.

Value may be one of "none", "pending", "pending_payment", "active", or "blocked"

topics

Topics related to the group, returned when fields request parameter value includes 'group_topics'

id

Numeric topic id

lang

Language topic originates from

name

Display name of the topic

urlkey

The unique keyword used to identify this topic

urlname

Alphanumeric urlname identifier for the group

who

What the group calls its members

how_to_find_us

Additional information on how to find members at a venue when provided by an organizer, returned when fields request parameter value includes 'how_to_find_us'

id

A unique alphanumeric identifier for event

link

Link to event on meetup.com

manual_attendance_count

Manually entered total attendee headcount, if any exists

name

Name of the event

photo_album

Information about photo uploads for this event, returned when fields request parameter value includes 'photo_album'

event

Event photo album belongs to. This will be absent if the album is not associated with an event

id

Alphanumeric event ID

name

Name of event

time

UTC start time of the event, in milliseconds since the epoch

utc_offset

The local offset from UTC time, in milliseconds

yes_rsvp_count

Number of yes RSVPs

id

Unique numeric identifier for photo album

photo_count

Number of photos uploaded

photo_sample

A small collection of photos uploaded for this event

base_url

A base url that can be use to construct a photo url from its components

highres_link

Link for full sized photo

id

Numeric photo ID

photo_link

Link for standard sized photo

thumb_link

Link for thumbnail sized photo

type

Type of photo. One of "event" or "member"

title

Album title

plain_text_description

Plain text version of the event description. Email addresses and photo numbers will be masked for non-members. Returned when "fields" request parameter value contains "plain_text_description"

rsvp_limit

The number of "yes" RSVPS an event has capacity for

rsvp_rules

Information about conditions that allow for member RSVPs, returned when fields request parameter value include 'rsvp_rules'

close_time

UTC time that RSVPs will no longer be accepted, though organizers may close RSVPs earlier

closed

Boolean value indicating whether or not RSVPing was explicitly closed for the event.

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'

rsvp_sample

A small collection RSVPs for members attending this event, returned when fields request parameter value includes 'rsvp_sample'

created

Creation time of the RSVP, in milliseconds since the epoch

id

Unique numeric identifier for the RSVP. May be -1 for events scheduled in the future

member

Member who RSVP'd

bio

Intro of member

event_context

Member's context within the event. Only returned in the context of an event

id

Numeric member ID

name

Name of member

photo

Member photo, if available. Members who registered via Facebook may not have highres photos

role

The leadership role of this member within the group, if any. Value may be one of assistant_organizer, coorganizer, event_organizer, organizer

self

Represents the authenticated member's relation to member. Returned with the "fields" request parameter includes "self" and the target member is not the authenticated member

title

Organizer defined title of member. May be absent if not defined

updated

Last modified time of the RSVP, in milliseconds since the epoch

rsvpable

Boolean value indicating whether or not the authenticated member can RSVP or join the waitlist when the event is full. Returned when the "fields" request parameter value includes "rsvpable"

rsvpable_after_join

Boolean value indicating whether or not the authenticated member can RSVP after joining the hosting group. Returned when the "fields" request parameter includes "rsvpable_after_join" and the authenticated member is not a member of the group hosting this event

self

represents details particular to the authorized user, only present if requested and authenticated member is a member of the hosting group, returned when fields request parameter value includes 'self'

actions

List of actions the authenticated member may perform, potentially one or more of the following

"announce" to announce the event to the group's members

"attendance" to view or take attendance for the event

"comment" the ability to post a comment or reply

"payments" the ability to mark members as paid if the event is ticketed

"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

"wait" to get on the waiting list (using the same RSVP methods).

"dues" if an organizer requires membership dues to RSVP and the authorized member has not paid theirs

"upload_photo" the ability to upload a photo for an event

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'

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

guests

Number of guests the RSVP'd member will be bringing

response

May be "yes" or "no".

In cases where an event is over capacity and the member has shown an intent to attend, response may be "waitlist" if the event has a waitlist.

In cases of ticketed events, this may be "yes_pending_payment" for a "yes" response for a ticketed event with an unprocessed payment

series

Returned when the "fields" request parameter value includes "series" for events that are part of a series of events

description

Human displayable description of how often events in this series occur

end_date

Date when this series ends/ended, in milliseconds since the epoch

id

Unique numeric identifier for the series

start_date

Date when this series begins/began, in milliseconds since the epoch

short_link

A shortened link for the event on meetup.com, returned when fields request parameter value includes "short_link"

simple_html_description

Description of the event, in simple HTML source format. If this event's description was saved in simple HTML format, the description field will be an HTML translation of this source. Returned when the "fields"' request parameter contains "simple_html_description"

status

"cancelled", "upcoming", "past", "proposed", "suggested", or "draft"

survey_questions

List of organizer-defined survey questions intended to be asked of RSVPing members. Returned when the "fields"' request parameter contains "answers"

id

Numeric question identifier

question

Question text

time

UTC start time of the event, in milliseconds since the epoch

updated

Last modified time for the event in milliseconds since the epoch

utc_offset

The local offset from UTC time, in milliseconds

venue

The event venue, present only if selected and not hidden by an organizer

address_1

Line 1 of venue address

address_2

Line 2 of venue address

address_3

Line 3 of venue address

city

City of venue

country

Country code of venue

id

Unique numeric venue id

lat

Approximate latitude

localized_country_name

The localized name of the venue's country

lon

Approximate longitude

name

Venue name

phone

Phone number of venue

repinned

true if the editor of the event altered the original venues pin location, false otherwise

state

State of venue where available

zip

ZIP code if, venue is in US or Canada

venue_visibility

Represents who can see the venue with a potential value of "members" or "public", returned when fields request parameter value includes "venue_visibility" and the authenticated member is a member of the group hosting the event

visibility

Event visibility: "public", "public_limited", or "members". Events in private groups that do not expose limited information are visible only to that group's members and should not be made public.

waitlist_count

Number of members on the waitlist, if one exists

why

We should do this because...

yes_rsvp_count

Number of yes RSVPs including guests

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated