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-lineeyefacebookfolderfullheartglobegmailgooglegroupsimageimagesinstagramlinklocation-pinm-swarmSearchmailmessagesminusmoremuplabelShape 3 + Rectangle 1outlookpersonJoin Group on CardStartprice-ribbonImported LayersImported LayersImported Layersshieldstartickettrashtriangle-downtriangle-uptwitteruseryahoo

Extend your community

Groups

GET /groups
  • json
  • rss
  • atom
  • xml
  • kml
Host: api.meetup.com
  • basic
api version 1

Deprecated: use /2/groups

API method for accessing meetup groups

Try it in the console

Request Parameters

At least one of the required parameter(s) must be supplied with the request. Answers to questions are expected to follow the naming convention: answer_{question_id}=myanswer when joining.

country, city, state

A valid country code, city and for the US, State. limits the returned groups to those within radius miles

fields

Set to "short_link" to include shortened group URLs in response items. Set to "join_info" to get a list of questions and requirements used when joining the group.

group_urlname

Return the group with this custom url path (e.g., the string "teaneck-archaeologists" would refer to the group located at http://www.meetup.com/teaneck-archaeologists)

id

Only return groups with the specified ID's [separate ID numbers with commas]

lat,lon

A valid latitude and longitude, limits the returned groups to those within radius miles

member_id

A member id number, limits results set to only those groups that the member specified by this id is currently a member of (excludes private groups, unless the member_id is the same as that of the member making the request)

radius

Radius, in miles for geographic requests, default 25 -- maximum 100

topic

Only return groups in the specified topic [one topic allowed]

topic, groupnum

Return the group with this topic and number

visibility

Set to "members" or "public" to restrict to groups of a particular visibility

zip

A valid US zip code, limits the returned groups to those within radius miles.

Ordering

ctime

group creation time [newest first]

location

group location, country, state [if present], city

members

number of members [largest first]

name

the name of the group

Response

country, city, state

Country, City, (and for the US, State) where this group is located

created

The date the group was created

daysleft

If this group is in need of an organizer, number of days until it expires (otherwise blank)

description

Description of the group

group_urlname

The group's url name

id

The groups's id

join_info

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

questions

List of questions asked by organizer

id

Unique identifier for the questions.

question

The text of the question

questions_required

"1" if required, "0" otherwise

lat

Latitude coordinates of group location

link

Link to the groups page

lon

Longitude coordinates of group location

members

The number of members in the group

name

The groups's name

organizerName

Name of the group's organizer

organizerProfileURL

Profile url of group organizer

photo_url

Url of the group's photo

rating

Group rating

short_link

short version of the group's link

topics

Topics related to this group

id

Topic ID

name

Topic name

urlkey

Unique keyword used to identify this topic

updated

The last date and time that the group was updated

visibility

Set to "members" or "public". Only authenticated group members can retrieve event and membership details for private groups

who

what the group calls its members

zip

The zip code where this group is located

Examples

Get a list of all groups near Williamsburg, Brooklyn ordered oldest first, in xml format.

https://api.meetup.com/groups.xml/?zip=11211&order=ctime&desc=true&key=ABDE12456AB2324445

List all the pug groups in Reno, Nevada return json.

https://api.meetup.com/groups.json/?&topic=pug&country=us&state=nv&city=reno&key=ABDE12456AB2324445

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated