The Wayback Machine - https://web-wp.archive.org/web/20140922020017/http://www.meetup.com:80/meetup_api/docs/stream/2/checkins/

Extend your community

Long-Polling Checkins Stream

GET /2/checkins
  • json
Host: stream.meetup.com
  • public
stream version 1

Deprecated

This long-polling stream can be easily consumed using JavaScript in any modern browser. Checkin notifications are received when they happen, or as soon as your script finishes handling its last notification.

Request Parameters

These parameters are set automatically by Meetup's must.js client.

callback
Name of a function to be called with an array of notification objects. If this parameter is not supplied, the chunked stream is joined instead.
event_id
Limit notifications to a specific event id. Use alphanumeric ids for repeating events.
since_count
Request that some number of recent messages be sent immediately, if available. May not be specified in the same request as since_mtime.
since_mtime
Should be supplied for all but the first polling request, so that any missed notifications are can be sent in an immediate response

Response

Checkin notification objects include these properties. This method's response is an array of zero or more of these, while Meetup's JS client calls your callback function with exactly one object.

checker
Member who performed the checkin, if not the same as the one who checked in
member_id
-
member_name
-
member_photo
URL of thumbnail
checkin_id
ID of the checkin
event_id
event checked into
lat
Latitude, if provided
lon
Longitude, if provided
member
Member who is checked in
member_id
-
member_name
-
member_photo
URL of thumbnail
time
checkin time in milliseconds since the epoch

Errors

connection_limit
the client IP has exceeded its maximum number of connections

WebSocket Checkins Stream

WS /2/checkins
  • json
Host: stream.meetup.com
  • public
stream version 1

Deprecated

For browsers that support it, WebSockets is a more efficient alternative to the long-polling stream. This is a push only endpoint and will discard any messages received from the client after the socket is open.

Because browser support for WebSockets is limited, we recommend that you consume this stream through the must.js client, which can fallback to long-polling.

Request Parameters

The full URL for this method is ws://stream.meetup.com/2/checkins

event_id
Limit notifications to a specific event id. Use alphanumeric ids for repeating events.
since_count
Request that some number of recent messages be sent immediately, if available. May not be specified in the same request as since_mtime.
since_mtime
Return recent messages with an mtime greater then the supplied time, in millisends since the epoch

Response

This stream includes the same JSON notification objects as its long-polling counterpart, one per WebSocket frame.

Errors

connection_limit
the client IP has exceeded its maximum number of connections

Chunked HTTP Checkins Stream

GET /2/checkins
  • json
Host: stream.meetup.com
  • public
stream version 1

Deprecated

This method serves checkin notifications using chunked encoding to maintian a persistent connection with a client. The connection will only be terminiated for server maintenance or a connection error. It is suitable for low-level HTTP clients rather than web browsers.

Request Parameters

event_id
Limit notifications to a specific event id. Use alphanumeric ids for repeating events.
since_count
Request that some number of recent messages be sent immediately, if available. May not be specified in the same request as since_mtime.
since_mtime
Return recent messages with an mtime greater then the supplied time, in millisends since the epoch

Response

This stream includes the same JSON notification objects as its long-polling counterpart. These are served one per HTTP chunk and terminated by newlines.

Errors

connection_limit
the client IP has exceeded its maximum number of connections

Examples

Try out the checkins stream on the command line

curl -i http://stream.meetup.com/2/checkins

API methods

everywhere seed events

Sign up

Meetup members, Log in

By clicking "Sign up" or "Sign up using Facebook", you confirm that you accept our Terms of Service & Privacy Policy