Welcome, Guest Sign In | Sign Up | Help
Upcoming API Documentation
Currently, the use of these APIs are restricted to non-commercial use only. If you'd like to use it for commercial purposes, please contact us first.
event.getGroups [HTTP GET]
For a given event_id, retrieve group information and metadata for public and private groups that include the event in their group calendar.
Explore event.getGroups
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

event_id (Required)
The id number of the event.

token (Optional)
An authentication token. Pass to see even private groups. (What's this?)

Example Response (Try It!)

XML

<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
	<group id="101" name="blasthaus fans" description="people in and around san
	francisco who go to blasthaus events. http://www.blasthaus.com/"
	event_moderation="1" member_moderation="1" is_private="0" timestamp="2005-09-02
	02:15:11" owner_user_id="2078" commercial_account_id="0" topic_count="0"
  member_count="15" 
	/> 
</rsp>
		

JSON

{ "rsp" : { "group" : [ { "commercial_account_id" : 0,
            "description" : "people in and around san francisco who go to blasthaus events. http://www.blasthaus.com/",
            "event_moderation" : 0,
            "id" : 101,
            "is_private" : 0,
            "member_count" : 55,
            "member_moderation" : 0,
            "moderation_level" : "unmoderated",
            "name" : "blasthaus fans",
            "num_members" : 55,
            "owner_user_id" : 2078,
            "timestamp" : "2005-09-02 02:15:11",
            "topic_count" : 1
          },
          { "commercial_account_id" : 0,
            "description" : "San Francisco don't tek no, but this list does.",
            "event_moderation" : 0,
            "id" : 780,
            "is_private" : 0,
            "member_count" : 145,
            "member_moderation" : 0,
            "moderation_level" : "unmoderated",
            "name" : "SF Techno",
            "num_members" : 145,
            "owner_user_id" : 7,
            "timestamp" : "2005-12-01 14:30:11",
            "topic_count" : 6
          },
          { "commercial_account_id" : 0,
            "description" : "For fans of electronica.",
            "event_moderation" : 0,
            "id" : 1245,
            "is_private" : 0,
            "member_count" : 172,
            "member_moderation" : 0,
            "moderation_level" : "unmoderated",
            "name" : "San Francisco Electronic Music",
            "num_members" : 172,
            "owner_user_id" : 39074,
            "timestamp" : "2006-01-25 22:23:14",
            "topic_count" : 1
          },
          { "commercial_account_id" : 0,
            "description" : "San Francisco underground house music group, and maybe some not too underground....  It's subjective..  Post events, talk records, clubs, stealth locations, dives w/ great DJs, etc.",
            "event_moderation" : 0,
            "id" : 2632,
            "is_private" : 0,
            "member_count" : 28,
            "member_moderation" : 0,
            "moderation_level" : "unmoderated",
            "name" : "SF House Headz",
            "num_members" : 28,
            "owner_user_id" : 105045,
            "timestamp" : "2007-01-24 21:22:56",
            "topic_count" : 0
          }
        ],
      "stat" : "ok",
      "version" : 1
    } 
}
Error Codes (sent in HTTP Response Header)
301 Moved Permanently:
  • The group <Event ID> has been permanently merged to http://upcoming.yahoo.com/group/<Event ID>/ - Please check the new URL to find the group.
403 Not Authorized:
  • Invalid authentication parameters - either that token was not found, or it may be deactivated. Please contact us for support.

404 Not Found:
  • Missing valid api_key - Please create an API key using the above link.
  • Your api_key is inactive or not found - Please contact us for support.
  • Missing valid event_id parameter - Your event_id may be improperly formatted or non-numeric. Only numeric event_id's are allowed.
Tools
Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help
News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board | About Us