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

OpenVenues

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

Searches for public venues within a given geo space. To search for specific venues that your group has used, use the Venues method

Try it in the console

Request Parameters

At least one of the required parameter(s) must be supplied with the request. If you are not able to provide a relative location you may supply a group_urlname which this method will use to infer location from. You can perform prefix searching by appending a * character to your query

city

A valid city

country

A valid country code.

fields

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

group_urlname

Returns venues with location relative to the group associated with this urlname

lat

A valid latitude, limits the returned venues to those within radius miles

lon

A valid longitude, limits the returned venues to those within radius miles

radius

Radius, in miles for geographic requests, default 25.0 -- maximum 100.0

state

For the US, a valid 2 character state code

text

Venues that contain the given term or terms somewhere in their content. Separate terms with " AND " for venues that have combined terms. Append a trailing * to treat this as a prefix search

zip

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

Ordering

distance

(default order) ordering is approximate and will not exactly match the values in the "distance" field.

rating

average member rating

rating_count

number of member ratings.

Response

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, County code and if in US state of venue

distance

Distance in miles from the search location, if one was specified

email

email address of venue

fax

fax number of venue

id

ID of the venue

lat, lon

coordinates of venue

localized_country_name

Name of country of venue

name

Name of the venue

phone

phone number of venue

rating

The average member rating

rating_count

The number of member ratings

taglist

Optional array of associated tagnames provided when a value of "taglist" is supplied with the "fields" request parameter

venue_url

URL of the venues's page on meetup.com

zip

if US or Canada

Examples

Search for public venues near the zipcode 10021

https://api.meetup.com/2/open_venues
    ?zip=10021
    &key=ABDE12456AB2324445

Search for the top 5 public venues near the zipcode 10021 with tagged with "wifi" and "coffee" with the highest rating

https://api.meetup.com/2/open_venues
   ?zip=10021
   &text=wifi and coffee
   &page=5
   &desc=true
   &order=rating
   &key=ABDE12456AB2324445

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated