Extend your community

Concierge

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

Recommends upcoming meetups for the authorized member in a given location and in thier groups

Try it in the console

Request Parameters

For geo-based requests, you may provide a location in one of three ways. By lat and lon, by zip, or by country, city, and optionally a state, if the provided country has states.

If the server is unable to produce recommendations in a suitable amount of time, a 503 error will be returned. If no parameters are specified, Meetups are recommended for the upcoming week in the member's default location.

Pagination works a little differently in this method than in others. Rather than using "offset" and "page" request parameters, this method uses an opaque "page_token" request parameter to determine the page of results returned. If there are more results, the "next" property of the meta section of the response will contain the next page's page_token. The number of results returned is not deterministic but a best-effort attempt will be made to return at least some.

category_id

Comma delimited list of category ids to limit recommendations to

city

A valid city

country

A valid country code

fields

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

lat

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

lon

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

page_token

An opaque string used to page through results. This can be found appended to the 'next' link in the meta section of the response.

radius

Radius, in miles for geographic requests, defaults to the member's preferred radius or 0.5 -- maximum 100. May also be specified as "smart", a dynamic radius based on the number of active groups in the area

self_groups

set to "include" or "exclude" groups the authorized member belongs to. The default is "include". This includes groups in locations that may differ than the provided location

state

If searching in a country with states, a valid 2 character state code

text_format

Format of the description text, "html", "plain", or "simplehtml". Defaults to "html"

time

Return events scheduled 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). Note: to retrieve past events you must also update status value

topic_id

Comma delimited list of topics to help inform recommendation

with_friends

Boolean parameter. When set to true, events hosted by groups you have friends in will be recommended

zip

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

Ordering

time

ascending time is the default and only ordering

Response

announced

Organizers and hosts can see if the event was announced

announced_at

Organizers and hosts can see when the event as announced in milliseconds since the epoch

comment_count

Returned when fields request parameter contains "comment_count" and represents number of comments posted to the event

created

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

description

Description of the event.

distance

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

duration

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.

email_reminders

Returned when fields request parameter contains "email_reminders" and is limited to organizers and event hosts, if false, event reminders are disabled

event_hosts

List of members hosting the event, only returned if requested in the fields parameter.

member_id

The host's member id

member_name

The host's member name

event_url

URL of the event's page on meetup.com

featured

Returned when fields request parameter contains "featured" and returns "true" if the event is featured and "false" otherwise

fee

Fee info returned when payment is defined

accepts

Accepted method of payment. Can be one of "paypal", "amazon", or "cash"

amount

Amount of the fee

currency

Currency accepted for fee

description

Fee description, typically "per person"

label

Fee label, typically "Price"

required

"1" if payment is required to RSVP, "0" otherwise

group

Group that is hosting the event

approved

Returned when fields request parameter contains "group_approved". True if this group has been approved. New groups are generally approved (or removed) soon after creation.

category

Optional field. Category of this group

id

Numeric identifier of the category

name

Display name of the category

shortname

String identifier of the category

created

Date and time that the group was founded, in milliseconds since the epoch

group_lat

Approximate group latitude

group_lon

Approximate group longitude

group_photo

Returned when fields request parameter contains "group_photo" and represents photo for the group hosting the event

highres_link

URL for the photo at its maximum size

photo_id

-

photo_link

URL for a standard size of the photo

thumb_link

URL for a thumbnail of the photo

id

Group id

join_mode

"open", "approval", or "closed"

membership_dues

Returned when fields request parameter contains "group_membership_dues"

currency

Currency fee is declared as

fee

Numeric fee value

fee_desc

Description of fee

methods

Array of acceptable payment methods. May be one or more of "amazon_payments", "paypal", "credit_card" or "other"

reasons

Array of reasons types in 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

Array of payment refund policies. May be one or more of "none", "member_leaves", "group_closes", "member_banned", or "custom"

required

"2" if dues are required to join, "1" if dues are required to RSVP, "0" otherwise

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

Group name

self

Returned when fields request parameter contains 'self_membership_dues' or 'group_status'

membership_dues

The authenticated member's group dues in the form returned by group endpoints

status

The member's status. May be one of 'active' or 'pending'

topics

Optional field. Topics related to this group

id

Topic ID

name

Topic name

urlkey

Unique keyword used to identify this topic

urlname

Group URL name

who

What the group calls its members

headcount

The number of members in attendance according to the attendance taker. This may be 0 if attendance has not yet been taken

how_to_find_us

The information provided by the event host for "How will members find you there?". Visible when location is visible to the authenticated member

id

The event id. May be numeric or alphanumeric, always served as a string

is_simplehtml

Optional field, "true" when the event has been saved in a simplified HTML format, "false" otherwise.

maybe_rsvp_count

Number of maybe RSVPs including guests

name

The name of the event

photo_album_id

Returned when fields request parameter contains "photo_album_id" and returns the ID of the photo album for this event, if one exists

photo_count

Returned when fields request parameter contains "photo_count" and represents number of photos posted to the event

photo_url

URL of the event photo, if one exists

publish_status

"published" or "draft" only visible to organizers

rating

Only past events have this field, an aggregate of anonymous ratings

average

Average of collected ratings

count

Number of ratings been collected

rsvp_alerts

Returned when fields request parameter contains "rsvp_alerts" and is limited to organizers and event hosts, if false, member RSVP alerts are disabled

rsvp_limit

The number of "yes" RSVPs an event can have before members will be added to the waiting list

rsvp_rules

Conditions set by the organizer, only returned if requested in the fields parameter.

close_time

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

closed

Flag indicating that RSVPing is closed for the event. 1 is true 0 is false

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"

rsvpable

Indicates if the currently authenticated member can RSVP or not, only returned if requested in the fields parameter

self

Returned when fields request parameter contains "self" and represents details particular to the authorized user, only present if requested and user is a member of the hosting group

actions

list of actions the current user may perform, potentially: "announce" to announce the event to the group's members, "attendance" to view or take attendance for the event, "payments" to mark members as paid if the event is a paid event, "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, or "wait" to get on the waiting list (using the same RSVP methods). For events without a waitlist, you may see either "watch" or "unwatch" to watch for opening spots for the event when the event is full. If an organizer requires membership dues to rsvp and the authorized member has not paid theirs, "dues" will be included

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'.

rated

Boolean indicator of whether the current member rated the event or not

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. By default, this field returns a list of strings answers. You can request more structured answer info including the time the answer was updated, by setting fields=rsvp_answer_info in the request. The structured format for answers is defined in Rsvp API's response

guests

number of guests

response

"yes", "no", or "waitlist"

watching

For events without waitlist you may check your watchlist status with this property. Values may either be true of false.

short_link

Returned when fields request parameter contains "short_link". If hosting group is private, this will return the group's short_link

simple_html_description

Optional field, description of the event in simple HTML format.

status

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

survey_questions

Returned when fields request parameter contains "survey_questions" for events with surveys

id

Question identifier

question

Question text

required

Flag indicating if a response to this question is required to RSVP. Currently always false.

time

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

timezone

Returned when fields request parameter contains "timezone". This represents the universal timezone identifier for the host group

trending_rank

Indicates the trending rank within the current result set. The best rank is zero, increasing rank values are less "trending". This value is only returned if requested in the fields parameter

updated

UTC last modified time of the event, in milliseconds since the epoch

utc_offset

The local offset from UTC time, in milliseconds

venue

Venue, if selected and not hidden

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

id

Venue id

lat, lon

Geographic coordinates of venue

name

Venue name

phone

Phone number of venue

repinned

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

zip

ZIP code if, venue is in US or Canada

venue_visibility

Set to "members" or "public". The "venue" element will not be present if the visibility is "members" and the current authenticated user is not a member of the group hosting the event. This value is only returned if requested in the fields parameter

visibility

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

why

We should do this because...

yes_rsvp_count

Number of yes RSVPs including guests

Examples

With only authorization parameters supplied, concierge recommends upcoming Meetup events in the member's default location.

curl https://api.meetup.com/2/concierge?key=API_KEY_HERE

API methods