Get Started!

Twtvite is a Twitter-based event manager tool for organizing Tweetups. At the moment, we allow read-only access to our data. Before you start, please create an API Key. Sign in with your Twitter account and fill out the form on the "API Key" tab.

API Methods

For all methods: Format JSON | HTTP Method: GET | Requires Authentication: false | Requres API Key: true

Events

YOUR_API_KEY = Create one here!
TWTVITE_ID = http://twtvite.com/abcdef

events/event_get - get an event info.

Url: http://twtvite.com/api/events/event_get/?api_key=YOUR_API_KEY&id=TWTVITE_ID

Output parameters: event (twtvite_id, event_name, event_description, event_info_url, start_date, end_date, event_timezone, event_hashtag, created_date, event_canceled, event_private), venue (venue_name, venue_address, venue_city), organizers, sponsors, partners, rsvp_num (yes, maybe, no, waiting_list)

events/rsvps_get - get list of RSVPs (Yes, Maybe, No) for an event.

Url: http://twtvite.com/api/events/rsvps_get/?api_key=YOUR_API_KEY&id=TWTVITE_ID

Output parameters: rsvp_num (yes, maybe, no, waiting_list), rsvp_list (name, rsvp_date)

events/comments_get - get comments for an event.

Url: http://twtvite.com/api/events/comments_get/?api_key=YOUR_API_KEY&id=TWTVITE_ID

Output parameters: comments (name, comment, comment_date)

Search

search/keyword - search public events by keywords.

Url: http://twtvite.com/api/search/keyword/?api_key=YOUR_API_KEY&keyword=SEARCH_TERM

Output parameters: events (event as in event_get)

search/location - search public events by city, state/region, country.

Url: http://twtvite.com/api/search/location/?api_key=YOUR_API_KEY&city=CITY_NAME&region=REGION_NAME&country=COUNTRY_NAME

Output parameters: events (event as in event_get)

Location Widget!

You can use our location widget on your website/blog to display the latest Tweetups by country/state. Simply copy/paste the code below and change the parameters as you need it.

<script src="http://twtvite.com/js/badge.js" type="text/javascript"></script> <script src="http://twtvite.com/badge/location/?n=10" type="text/javascript"></script>

Input parameters
n = number of place to display.
nl = display Twtvite logo (1 = not display | 0 = display, default).
co = country (ISO country code. Ex: us = United States, au = Australia, de = Germany, etc.).
s = state/region (for the United States, United Kingdom, Australia, Brazil, Canada, India).
nco = except country (displays all except country).

Example
http://twtvite.com/badge/location/?co=us&s=ca - Returns Tweetups in the State of California.
http://twtvite.com/badge/location/?n=5&nco=us - Returns the top 5 Tweetups excluding the United States.