addressalign-toparrow-leftarrow-rightbackbellblockcalendarcameraccwcheckchevron-downchevron-leftchevron-rightchevron-small-downchevron-small-leftchevron-small-rightchevron-small-upchevron-upcircle-with-checkcircle-with-crosscircle-with-pluscontroller-playcredit-cardcrossdots-three-verticaleditemptyheartexporteye-with-lineeyefacebookfolderfullheartglobe--smallglobegmailgooglegroupshelp-with-circleimageimagesinstagramFill 1languagelaunch-new-window--smalllight-bulblinklocation-pinlockm-swarmSearchmailmediummessagesminusmobilemoremuplabelShape 3 + Rectangle 1ShapeoutlookpersonJoin Group on CardStartprice-ribbonprintShapeShapeShapeShapeImported LayersImported LayersImported Layersshieldstartickettrashtriangle-downtriangle-uptwitteruserwarningyahooyoutube

Extend your community

Recommended Groups

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

Returns groups Meetup finds relevant to you

Try it in the console

Request Parameters

All parameters are optional. You may change the 'location' and 'radius' for the request. If you do not supply a location your request will be based on your IP's geographic location. If the server is unable to produce recommendations in a suitable amount of time, a 503 error will be returned.

category

A valid category id which limits recommended groups to a particular category

country

A valid two character country code, defaults to US

fields

Request that additional fields (separated by commas) be included in the output.

instant_join_only

Recommend only groups without join requirements and that can be joined instantly

lat

Approximate latitude

location

Raw text location query

lon

Approximate longitude

radius

Radius in miles. May be 0.0-100.0, 'global' or 'smart', a dynamic radius based on the number of active groups in the area. Defaults to member's preferred radius

sort

How to order the results. Valid values are "default" or "static".

topic_id

Comma delimited list of up to 100 topic ids to help inform recommendations

zip

Zip code you are searching for recommendations in

Response

approved

Boolean indicator for whether this Group has been approved or not. New Groups are generally approved (or removed) soon after creation. Returned when the "fields" request parameter value includes "approved"

category

The primary category of the group, if the group has one

id

Numeric category id

name

Display name of the category

shortname

String identifier of the category

sort_name

Name used for sorting

city

City of the group

city_link

Optional field, a URL for the group's city

contributions

Optional field containing the contribution details of the group

enabled

Boolean stating if contributions are enabled for the group

potential

Boolean stating that potential contributions are enabled for the group

reason

The reason a member might consider contributing

thanks

The 'thank you' message to be given when a contribution is made

country

Country of the group

created

Time the group was created in milliseconds since the epoch

description

Short description of group

discussion_preferences

Optional field that contains preference and permission data for group discussions

draft_event_count

Optional fields parameter. Returns the number of draft events belonging to the group.

fee_options

Optional field, returns payment options for event ticketing

currencies

Acceptable currencies for the payment method specified by type

code

Currency accepted for fee

default

A boolean set to true if the currency is the group's default currency, false otherwise

is_setup

A boolean set to true if the payment method specified by 'type' is set up for the group

setup_link

The URL for setting up the payment method specified by 'type'. This is returned if the payment method specified by 'type' is not set up for the group and the member has the permission to set it up

type

Acceptable methods of payments may be one of Set(none, cash, paypal, wepay)

ga_code

Optional field return the Google Analytics code for the group. Only members that can edit group settings can see this

group_photo

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"

id

Numeric group ID

is_simplehtml

Optional field, 'true' when the group description has been saved in a simplified HTML format, 'false' otherwise.

join_info

Optional field, lists any questions requested when joining and required fields

photo_req

true if required, false otherwise

questions

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

id

Unique numeric identifier for the question

question

The text of the question

questions_req

true if required, false otherwise

join_mode

Who can join this group and how. One of "approval", "closed", or "open"

key_photo

Group primary 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"

last_event

Optional field representing the last hosted event, if the group has one. Returned when the "fields" request parameter value contains "last_event"

id

Alphanumeric event ID

name

Name of event

no_rsvp_count

Number of no RSVPs, included if the rsvp_counts field is set

time

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

utc_offset

The local offset from UTC time, in milliseconds

waitlist_count

Number of waitlisted RSVPs, included if the rsvp_counts field is set

yes_rsvp_count

Number of yes RSVPs

lat

Latitude

leader_limit

Meetup leaders limit in group (4 leaders for the Basic Subscription), note this info available only for orgs and coorgs

leads

Optional field representing the number of members on this group's leadership team. Returned when the "fields" request parameter value contains "leads"

link

Link to group on meetup.com

list_addr

Optional field returning list address prefix. List mail will be {list_addr}-list@meetup.com. Announce email will be {list_addr}-announce@meetup.com. You must be a member of the group to see this

list_mode

Optional field representing the policy for who can post the group mailing list. Returned when the "fields" request parameter value contains "list_mode". Value may be one of "moderated", "off", "open", or "orgs_only"

localized_country_name

Name of country of the group

localized_location

City/State or City/Country of the group

lon

Longitude

member_cap

Number representing the maximum number of active members this group can have if capped. Returned only when requested in the fields request parameter and the authenticated member has permission to approve members

member_limit

Meetup members limit in group (now it's 50 members in the Basic Subscription)

members

Number of Meetup members in this group

membership_dues

Optional field, returns membership dues for group if any

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

amazon_payments

Boolean indicator that Amazon Payments are accepted

credit_card

(Deprecated - use wepay instead) Boolean indicator that credit cards are accepted

other

Boolean indicator that other forms of payment are accepted

paypal

Boolean indicator that Paypal payments are accepted

wepay

Boolean indicator that Wepay payments are accepted

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

custom

Boolean indicator of a custom refund policy

group_closes

refund applies when the group closes

member_banned

refund applies when the member is banned

member_leaves

refund applies when member leaves the group

none

indicates there is no refund policy

required

true if dues are required

required_to

If the dues are required this indicates what they are required for. Currently may only be 'join'

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

meta_category

The meta category of the group, if the group has one

best_topics

Represents the best topic matches for this category, returned when the "fields" request parameter value includes "best_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

category_ids

List of numeric category ids associated with this topic category

id

Numeric topic-category id

name

Display name of the topic-category

photo

Photo representing this category

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"

shortname

Unique string identifier for this category

sort_name

Name used for sorting

name

Name of the group

next_event

The current ongoing or next upcoming event, if one is scheduled

id

Alphanumeric event ID

name

Name of event

no_rsvp_count

Number of no RSVPs, included if the rsvp_counts field is set

time

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

utc_offset

The local offset from UTC time, in milliseconds

waitlist_count

Number of waitlisted RSVPs, included if the rsvp_counts field is set

yes_rsvp_count

Number of yes RSVPs

nominated_member

Optional fields parameter. Returns if the logged in member has been nominated to take over the group.

organizer

Group's primary organizer

bio

Bio of member

id

Numeric member ID

name

Name of member

photo

Organizer photo, where defined

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"

past_event_count

Optional fields parameter. Returns the number of past events belonging to the group.

pending_members

Number representing the count of members pending organizer approval to join. Returned only when requested in the fields request parameter and the authenticated member has permission to approve members

photo_gradient

Color combination used generate group duotone

composite_color

Composite color in hexidecimal format

dark_color

Dark color in hexidecimal format

id

Unique numeric identifier

light_color

Light color in hexidecimal format

photos

A small set of photos from the group

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"

plain_text_description

Description of the group, in plain text format. Returned when then "fields" request parameter value contains "plain_text_description"

plain_text_no_images_description

Description of the group, in plain text format with no images. Returned when then "fields" request parameter value contains "plain_text_no_images_description"

proposed_event_count

Optional fields parameter. Returns the number of proposed events belonging to the group.

score

A numeric value representing how the relevancy of the group in this search context

self

Optional field, contains details specific to the authorized user in this Meetup Group

actions

List of actions the authenticated member may perform, potentially "broadcast_message": the ability to broadcast messages to group members via the "announce" mailing list, "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

Member's membership dues if the group has membership dues

cancelled

For groups with recurring billing periods, this Boolean field indicates that membership dues were cancelled

exempt

For groups with recurring billing periods, this Boolean field indicates that the member is exempt from payment.

paid_until

For groups with recurring billing periods, this returns the time in milliseconds since the epoch that the member's next payment is due

period_status

For groups with recurring billing periods, this returns one of the following values grace paid pending unpaid

total_amount

Total amount paid

transaction_time

Time the transaction was made in milliseconds since the epoch

trial

If the group offers a trial membership, this indicates information for unpaid members.

previous_membership_dues

Member's membership dues history when currently not a part of group i.e Status=none if the group has membership dues

cancelled

For groups with recurring billing periods, this Boolean field indicates that membership dues were cancelled

exempt

For groups with recurring billing periods, this Boolean field indicates that the member is exempt from payment.

paid_until

For groups with recurring billing periods, this returns the time in milliseconds since the epoch that the member's next payment is due

period_status

For groups with recurring billing periods, this returns one of the following values grace paid pending unpaid

total_amount

Total amount paid

transaction_time

Time the transaction was made in milliseconds since the epoch

trial

If the group offers a trial membership, this indicates information for unpaid members.

role

Member's role in group, if any: Organizer, Assistant Organizer, Event Organizer, etc.

status

Indicates the authorized user's membership with this group. Value may be one of "none", "pending", "pending_payment", "active", or "blocked"

visited

Member's last visit to the group site, in milliseconds since the epoch

short_link

Optional field, a shorted URL for the group

similar_groups

Optional fields parameter. Returns up to 5 groups similar to this groups, best suited for the authenticated member when a single group is queried for. Note: this field is being deprecated in favor of making a separate request to /:urlname/similar_groups

id

Id of the group

join_mode

Who can join this group and how. One of "approval", "closed", or "open"

lat

Latitude

lon

Longitude

name

Name of the group

photos

Optional fields parameter. A small set of photos from the group

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"

urlname

Urlname used to identify the group on meetup.com

who

What this group calls it's members

simple_html_description

Description of the group, in simple HTML source format. If this group'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 value contains "simple_html_description"

state

State of the group, if in US or Canada

status

Status of the group

timezone

This represents the universal timezone identifier for the group

topics

Optional fields parameter. Returns the group's 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

untranslated_city

City of the group, not translated

urlname

Urlname used to identify the group on meetup.com

visibility

Who can see this group. One of members, public or public_limited

welcome_message

Optional fields parameter. Returns the Group's default welcome message if the authenticated member is the organizer of the group

who

What the group calls its members

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated