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 Venues

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

Returns venues Meetup finds relevant to you based on location and category. This method does not yet support sorting or pagination.

Try it in the console

Request Parameters

All parameters are optional. 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

Comma-delimited list of up to 200 category ids to help inform recommendations

country

A valid two character country code, defaults to US

group_id

Comma-delimited list of up to 200 group ids to help inform recommendations

group_urlname

Comma-delimited list of up to 200 group urlnames to help inform recommendations

lat

Approximate latitude

location

Raw text location query

lon

Approximate longitude

min_groups

The minimum number of groups that have hosted events at this venue

radius

Radius in miles. Defaults to member's preferred radius

used_between

Return venues that have been used 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).

zip

Zip code you are searching for recommendations in

Response

address_1

If available, the first address line of the venue

address_2

If available, the second address line of the venue

address_3

If available, the third address line of the venue

city

If available, the name of the venue's city

country

If available, the name of the venue's country code

id

Id, of the venue

lat

If available, the venue's latitude

localized_country_name

If available, the localized name of the venue's country

lon

If available, the venue's longitude

name

If available, the venue's name

phone

If available, the venue's photo number

rating

The average rating for the venue

rating_count

The number of times the venue was rated

state

If available, and the venue's country id is within the US or Canada, the venue's state

taglist

list of string tags associated with the venue. returned when fields=taglist

visibility

'private' if this venue is a private home, otherwise 'public'

zip

If available, the venue's ZIP code

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated