API List

Note those that have "future release" listed will be released, well, in the future.

1. Search
2. Asset Syndication
3. Asset Syndication Widget
4. Active Resource
5. Reviews (future release)
6. Results (future release)

Search

The Active Search API processes simple HTTP GET requests.  The results are returned in a variety of formats such as xml and JSON.  The API supports keyword search against Active.com assets, result restriction to a particular location, and result filtering based on asset metadata.

URL: http://api.amp.active.com/search?{queryString params}&api_key={key}
Method: GET

Sample Request - return search results for the query "half marathon",

http://api.amp.active.com/search?k=half+marathon&v=xml&api_key=wuhmn9ye94xn3xnteudxsavw

API Parameters

v = view
The results of a search is available in several different formats.  The available values are:
   
   xml
   json
   ical
   rss

k = keywords
The free-form query to search (equivalent to what a user types in the search box on search.active.com).

example:  http://api.amp.active.com/search?k=half+marathon&v=xml&api_key=wuhmn9ye94xn3xnteudxsavw

l = location
To narrow a search to a geographic area, use the l parameter to specify a location.  The formats available are:
    city,state,country
    postal code,country
    state,country
    postal code (US is assumed country)
    state (US is assumed country) 

example: http://api.amp.active.com/search?k=half+marathon&v=xml&l=92104&api_key=wuhmn9ye94xn3xnteudxsavw

r = radius
If a location is passed in, a radius can be specified to search as an integer.  If this parameter is not specified, the system uses the default radius of 50 miles.  For example, to limit your search to 25 miles:
http://api.amp.active.com/search?k=running&l=92104&r=25&v=xml&api_key=wuhmn9ye94xn3xnteudxsavw

m = meta
The meta filter allows filtering based on the metadata of our assets.  To filter on a metadata field, prefix meta: to the field name followed by an equal sign and then the value.  The value must be double URL encoded.  For example, to filter your search based on channel, you would specify:

http://api.amp.active.com/search?k=Fall+Classic&v=xml&m=meta:channel=Mountain%2520Biking&api_key=wuhmn9ye94xn3xnteudxsavw
    
To filter on multiple meta fields, list the meta filters separated by a space:

http://api.amp.active.com/search?k=Fall+Classic&v=xml&m=meta:channel=Mountain%2520Biking+meta:category=activities&api_key=wuhmn9ye94xn3xnteudxsavw

When multiple meta filters are passed in, an implicit AND is applied between the filters.  A boolean OR can be specified between the meta filters by using the word OR:

http://api.amp.active.com/search?k=Fall+Classic&v=xml&m=meta:channel=Mountain%2520Biking+OR+meta:channel=Cycling&api_key=wuhmn9ye94xn3xnteudxsavw
   
To exclude any assets with a meta filter, use the word NOT before the filter:

http://api.amp.active.com/search?k=Fall+Classic&v=xml&m=NOT+meta:channel=Mountain%2520Biking&api_key=wuhmn9ye94xn3xnteudxsavw

See Asset Metadata section for more information.

date range
To specify a date range, use the daterange keyword after the meta filter.  The daterange keyword takes the format of metafilter:daterange:{startDate}..{endDate}.  The startDate/endDate parameters can either be in the format of yyyy-MM-dd or a natural language word/phrase (e.g. today, tomrrow, a month from now, etc).  At least either a startDate or endDate must be specified.  

To get assets in the future:
    
http://api.amp.active.com/search?k=10k&v=xml&m=meta:startDate:daterange:today..+meta:channel=Running&api_key=wuhmn9ye94xn3xnteudxsavw
    
To get assets before November 1, 2009:
    
http://api.ampactive.com/search?k=10k&v=xml&m=meta:startDate:daterange:..11%2F01%2F2009+meta:channel=Running&api_key=wuhmn9ye94xn3xnteudxsavw
    
To get assets between March 1, 2009 and today:
    
http://api.amp.active.com/search?k=10k&v=xml&m=meta:startDate:daterange:03%2F01%2F2009..today+meta:channel=Running&api_key=wuhmn9ye94xn3xnteudxsavw

f = facets
We have several different types of data in the Search index.  To restrict a search to a particular type, use the facet parameter.  The available values are:
    activities - things like running events or camps
    results - race results from results.active.com
    training - training plans
    articles - articles on active.com and ihoops.com

s = sort
The default sort for results is by relevance.  The available values are:
    date_asc
    date_desc
    relevance

example: Sort running events by startDate, ascending-  http://api.amp.active.com/search?k=running&v=xml&s=date_asc&api_key=wuhmn9ye94xn3xnteudxsavw

num = number of results to return

The default number of results returned is 25.  To request a different amount, use this parameter with an integer as a value.  For example, to get a list of 50 results: 

example:  http://api.amp.active.com/search?k=running&v=xml&num=50&api_key=wuhmn9ye94xn3xnteudxsavw

page = used for paging through results
To page through a result set, use the page parameter in addition to the num parameter to get the desired results page.  For example, to split the results up into pages of 50 results:

http://api.amp.active.com/search?k=running&v=xml&num=50&page=1&api_key=wuhmn9ye94xn3xnteudxsavw

To get the second page of results:
http://api.amp.active.com/search?k=running&v=xml&num=50&page=2&api_key=wuhmn9ye94xn3xnteudxsavw

Asset Metadata

The assets in our index have a large number of metadata fields associated with them.  In this section we'll cover the major metadata fields.  All the metadata fields for a particular asset are returned when requesting results in xml or json formats.

Categories - use "category" as the filter name

example: m=meta:category=training%2520plans
Valid values:

• activities
• articles
• training plans

Channels - use "channel" as the filter name

example: m=meta:channel=Running
Valid values:

• Baseball
• Basketball
• Cycling
• Outdoors\Fishing
• Football
• Golf
• Ice Hockey
• Lacrosse
• Mountain Biking
• Running
• Soccer
• Softball
• Swimming
• Tennis
• Triathlon
• Volleyball
• Walking

Media Types - use "splitMediaType" as the filter name
example: m=meta:channel=Running+meta:splitMediaType=5k

Valid Values:

when "channel=Running", i.e. "m=meta:channel=Running+meta:splitMediaType=5k"

• Event
• Marathon
• Half Marathon
• 5k
• 10k
• 1 mile
• 5 mile
• 15k
• 10 mile
• Ultra
• Fun Run
• Kids Run
• Training Run
• Camp
• Clinic

when "channel=Triathlon, i.e. "m=meta:channel=Triathlon+meta:splitMediaType=Sprint"

• Event
• Sprint
• Kids Triathlon
• Olympic/International
• Long Course
• Camp
• Clinic

when "channel=Cycling", i.e. "m=meta:channel=Cycling+meta:splitMediaType=Event"

• Event

Asset Syndication

The Asset Syndication API is a REST web service, which provides read access to Active assets.  Note, this service is deprecated, and it is recommended to use the Search API instead. The service enables client applications to query Active with predefined filters. Currently, the Asset Syndication Service returns data only about Triathlon, Cycling and Running events.

Parameters

^_*The proximity search requires both zip and distance.

**mediaTypes are treated as Strings, not enumerations.  The table below lists valid mediaTypes for each supported event/activity type.

***dma's are also treated as Strings.  The table called "Valid 'dma' values" has a list of the supported dmas.

¹ the startDate and endDate filters must be included together; it is not possible to pass only startDate or endDate.

Sample Request

The filters are passed to the syndication service via an HTTP GET operation. Requests for the following event/activity types are supported:

• running
• triathlon
• cycling
• green (environmentally friendly)
• tennis

And here are examples for each (all return events/activities happening in the future):

1. All Half Marathon Events  http://api.amp.active.com/assets/running?mediaType=Event\Half Marathon&api_key=9h9kunucdnzmmct9xuseqftw
2. Sprint Triathlons  http://api.amp.active.com/assets/triathlon?mediaType=Event\Sprint&api_key=9h9kunucdnzmmct9xuseqftw
3. Cycling events http://api.amp.active.com/assets/cycling?api_key=9h9kunucdnzmmct9xuseqftw
4. Environmentally friendly events http://api.amp.active.com/assets/green?api_key=9h9kunucdnzmmct9xuseqftw
5. Tennis tournaments within 50 miles of Brooklyn, NY http://api.amp.active.com/assets/tennis?mediaType=Tournament&zip=10471&distance=50&api_key=9h9kunucdnzmmct9xuseqftw

Valid "mediaType" values per activity/event type

To get a list of all upcoming tennis classes, issue the following query using mediaType:

http://api.amp.active.com/assets/tennis?mediaType=Class&api_key=9h9kunucdnzmmct9xuseqftw

Valid "dma" values

To get a list of all upcoming cycling events in the Denver DMA, for example, issue this query:

http://api.amp.active.com/assets/cycling?dma=Denver&api_key=9h9kunucdnzmmct9xuseqftw

Escaping Filter Parameters

IBM has a good site describing how to escape special characters in URLs, check it out here.  Below are examples of common escape sequences.

Filter parameters with multiple values are separated by a pipe (|) and encoded as %7C.
Example: channel=Baseball%7Cbasketball

Values with spaces, such as 'Action Sports' are encoded with a +.
Example: channel=Action+Sports

Filter values that contain an ampersand (&) are encoded as %26.
Example: channel=Giving+%26+Fundraising

Filter values that contain a forward slash(/) are encoded as %2F.
Example: channel=Wake%2FKite%20Boarding

Sample Response

Download the XSD here.

<?xml version="1.0" encoding="UTF-8"?>
<assetCollection recordcount="40">
  <asset>
    <assetId>C97CC206-7F1D-4F01-93D2-14D8A0CDE44D</assetId>
    <assetName>San Diego Rock and Roll Marathon Pasta Party</assetName>
    <category>Activities</category>
    <channel>Running</channel>
    <mediaType>Event</mediaType>

    <mediaType>Event\Marathon</mediaType>
    <participationCriteria>Family</participationCriteria>
    <onlineRegistrationAvailable>true</onlineRegistrationAvailable>
    <onlineDonationAvailable>false</onlineDonationAvailable>
    <onlineMembershipAvailable>false</onlineMembershipAvailable>
    <trackback>http://www.active.com/page/Event_Details.htm?event_id=1731739&assetId=C97CC206-7F1D-4F01-93D2-14D8A0CDE44D</trackback>

    <location>
      <locationName>Hilton San Diego Bayfront</locationName>
      <city>San Diego</city>
      <state>California</state>
      <zip>92101</zip>
      <country>United States</country>

    </location>
    <contact>
      <contactEmail>go2l@pipeline.com</contactEmail>
      <contactPhone>310-980-7788</contactPhone>
    </contact>
    <date>
      <startDate>2009-05-30</startDate>

      <startTime>17:00:00</startTime>
      <endDate>2009-05-30</endDate>
      <endTime>17:00:00</endTime>
    </date>
    <media>
      <image>http://www.active.com/images/events/hotrace.gif</image>
    </media>

  </asset>
  <asset>
    <assetId>23DA56A6-4A72-41D5-9B28-05FC1F17A027</assetId>
    <assetName>Kevin Test Marathon</assetName>
    <category>Activities</category>
    <channel>Running</channel>
    <mediaType>Event</mediaType>

    <participationCriteria>Adult</participationCriteria>
    <onlineRegistrationAvailable>true</onlineRegistrationAvailable>
    <onlineDonationAvailable>false</onlineDonationAvailable>
    <onlineMembershipAvailable>false</onlineMembershipAvailable>
    <trackback>http://www.active.com/page/Event_Details.htm?event_id=1434160&assetId=23DA56A6-4A72-41D5-9B28-05FC1F17A027</trackback>
    <location>

      <locationName>San Diego</locationName>
      <city>San Diego</city>
      <state>California</state>
      <zip>92103</zip>
      <country>United States</country>
      <latitude>32.7469</latitude>

      <longitude>-117.1664</longitude>
    </location>
    <contact>
      <contactEmail>kevin.burke@active.com</contactEmail>
      <contactPhone>858-555-5555</contactPhone>
    </contact>
    <date>

      <startDate>2009-08-30</startDate>
      <startTime>9:00:00</startTime>
      <endDate>2009-08-10</endDate>
      <endTime>9:00:00</endTime>
    </date>
    <media>
      <image>http://www.active.com/images/events/hotrace.gif</image>

    </media>
  </asset>
</assetCollection>

<?xml version="1.0" encoding="UTF-8"?>
<assetCollection recordcount="40">
  <asset>
    <assetId>C97CC206-7F1D-4F01-93D2-14D8A0CDE44D</assetId>
    <assetName>San Diego Rock and Roll Marathon Pasta Party</assetName>
    <category>Activities</category>
    <channel>Running</channel>
    <mediaType>Event</mediaType>

    <mediaType>Event\Marathon</mediaType>
    <participationCriteria>Family</participationCriteria>
    <onlineRegistrationAvailable>true</onlineRegistrationAvailable>
    <onlineDonationAvailable>false</onlineDonationAvailable>
    <onlineMembershipAvailable>false</onlineMembershipAvailable>
    <trackback>http://www.active.com/page/Event_Details.htm?event_id=1731739&assetId=C97CC206-7F1D-4F01-93D2-14D8A0CDE44D</trackback>

    <location>
      <locationName>Hilton San Diego Bayfront</locationName>
      <city>San Diego</city>
      <state>California</state>
      <zip>92101</zip>
      <country>United States</country>

    </location>
    <contact>
      <contactEmail>go2l@pipeline.com</contactEmail>
      <contactPhone>310-980-7788</contactPhone>
    </contact>
    <date>
      <startDate>2009-05-30</startDate>

      <startTime>17:00:00</startTime>
      <endDate>2009-05-30</endDate>
      <endTime>17:00:00</endTime>
    </date>
    <media>
      <image>http://www.active.com/images/events/hotrace.gif</image>
    </media>

  </asset>
  <asset>
    <assetId>23DA56A6-4A72-41D5-9B28-05FC1F17A027</assetId>
    <assetName>Kevin Test Marathon</assetName>
    <category>Activities</category>
    <channel>Running</channel>
    <mediaType>Event</mediaType>

    <participationCriteria>Adult</participationCriteria>
    <onlineRegistrationAvailable>true</onlineRegistrationAvailable>
    <onlineDonationAvailable>false</onlineDonationAvailable>
    <onlineMembershipAvailable>false</onlineMembershipAvailable>
    <trackback>http://www.active.com/page/Event_Details.htm?event_id=1434160&assetId=23DA56A6-4A72-41D5-9B28-05FC1F17A027</trackback>
    <location>

      <locationName>San Diego</locationName>
      <city>San Diego</city>
      <state>California</state>
      <zip>92103</zip>
      <country>United States</country>
      <latitude>32.7469</latitude>

      <longitude>-117.1664</longitude>
    </location>
    <contact>
      <contactEmail>kevin.burke@active.com</contactEmail>
      <contactPhone>858-555-5555</contactPhone>
    </contact>
    <date>

      <startDate>2009-08-30</startDate>
      <startTime>9:00:00</startTime>
      <endDate>2009-08-10</endDate>
      <endTime>9:00:00</endTime>
    </date>
    <media>
      <image>http://www.active.com/images/events/hotrace.gif</image>

    </media>
  </asset>
</assetCollection>

<?xml version="1.0" encoding="UTF-8"?>
<assetCollection>
    <asset>
        <assetId>1cd49ffe-1621-4717-a7fe-0fdcdc2dcfdc</assetId>
        <assetName>Mt. Rainier Baseball - Babe Ruth / Cal Ripken</assetName>
        <category>Activities</category>
        <channel>Baseball</channel>
        <channel>SoftballPitch</channel>
        <mediaType>Tournament</mediaType>
        <summary>...</summary>
        <allText>...</allText>
        <participationCriteria>Youth</participationCriteria>
        <onlineRegistrationAvailable>true</onlineRegistrationAvailable>
        <onlineDonationAvailable>false</onlineDonationAvailable>
        <onlineMembershipAvailable>false</onlineMembershipAvailable>
        <trackback>http://www.active.com/page/Event_Details.htm?event_id=1488458</trackback>
        <location>
            <city>Enumclaw</city>
            <state>Washington</state>
            <zip>98022</zip>
            <country>United States</country>
        </location>
        <contact>
            <contactEmail>support@playmrba.org</contactEmail>
            <contactPhone>1-888-643-MRBA</contactPhone>
        </contact>
        <date>
            <startDate>2008-03-01</startDate>
            <startTime>0:00:00</startTime>
            <endDate>2008-06-01</endDate>
            <endTime>0:00:00</endTime>
        </date>        
        <media>
            <image>http://www.active.com/images/events/hotrace.gif</image>
            <image>http://www.active.com/images/upimages/mrba_logo_sm.jpg</image>
        </media>
    </asset>
</assetCollection>

Expires HTTP Header:

The Expires entity-header field gives the date/time after which the response is considered stale. Each service response will include an expires header. The response will not change before the header value is past.

Example Expires Header:
Expires: Sat, 24 May 2008 01:47:08 GMT

http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html (See 14.21 Expires)

Asset Syndication Widget

The Asset Syndication API might be complex for a less technical developer to consume.  We've created a generic Asset Syndication Widget that makes it easy to incorporate Active.com assets on a website.  This widget queries the Search API and exposes query parameters as JSON objects.  But you must apply for an Asset Syndication API key to use this widget.

Embed Code

<script type="text/javascript">
TAN_Syndication_title = "Running Events in San Diego";    
TAN_Syndication_filter = {f: 'Activities', startDate: 'tomorrow..', channel: 'Running', num: 10, l: 92109, r: 25, s: 'date_asc'};
</script>
<script type="text/javascript" src="http://api.amp.active.com/widgets/assets?api_key={api_key}"></script>

Parameters
TAN_Syndication_title - changes the title at the top of the widget
TAN_Syndication_filter - used to specify Asset Syndication API filters here in JSON format. Note "category" should always have a value of "Activities".

Also, the Asset Syndication API access key granted by Active.com must be copied into the {api_key} placeholder within the embed code.

Sample

Note the example above also makes use of custom, inline styles using CSS hooks created by the widget.  The idea here is to provide access for UI developers to add their UI magic.  These hooks are:

TAN_container
TAN_container_wrapper
TAN_container_header
TAN_container_content

And here's the embed code illustrating how the example is configured

<style>
.TAN_container {
    margin:0 0 1.12em;
    overflow:hidden;
    background: transparent url(http://api.active.com/widgets/assets/images/default/container/TAN_container_topleft.gif) no-repeat top left;}
.TAN_container * {margin:0; padding:0;}
.TAN_container .bold {font-weight:bold;}
.TAN_container .clear:after {
    content:"."; 
    display:block; 
    height:0; 
    clear:both; 
    visibility:hidden;} 
.TAN_container .clear {display: inline-block;} 
* html .clear {height: 1%;} 
.TAN_container .clear {display: block;}
.TAN_container_wrapper {
    background: transparent url(http://api.active.com/widgets/assets/images/default/container/TAN_container_bottomleft.gif) no-repeat bottom left;}
.TAN_container_header {
    background: transparent url(http://api.active.com/widgets/assets/images/default/container/TAN_container_topright.gif) no-repeat top right;
    padding:0.69em 0.69em 1em;}
.TAN_container_header h3 {
    font-size:1.2em;
    text-transform:lowercase;
    color:#0E4273;}
.event{margin-top:8px;}
.TAN_container_content {
    padding:.69em;
    background: transparent url(http://api.active.com/widgets/assets/images/default/container/TAN_container_bottomright.gif) no-repeat bottom right;}

</style>

<div style="width:400px">
    <script type="text/javascript">
    TAN_Syndication_title = "Running Events in San Diego";    
    TAN_Syndication_filter = {f: 'Activities', startDate: 'tomorrow..', channel: 'Running', num: 10, l: 92109, r: 25, s: 'date_asc'};    
    TAN_Syndication_newWindow = false;    
    </script>
    <script type="text/javascript" src="http://api.amp.active.com/widgets/assets?api_key=9h9kunucdnzmmct9xuseqftw"></script>
</div>

Resources

Active Resource API

active.com is host to a registration engine through which Event Directors create events, such as marathons or 10ks, and participants sign up for them.  Event details are displayed in HTML on active.com, such as this page for the Callaway Gardens Marathon.  Event data can also be retrieved programmatically through the Active Resource API.

This API is also useful when additional data about an asset returned by the Asset Syndication API is needed.  A query to this API might return a list of cycling events in Denver, for example, and a query to the Active Resource API for a given assetId returned in that list will return the desired "extended" information.

URL: http://api.amp.active.com/resource/regcenter/event/{eventId}?api_key={key} or

http://api.amp.active.com/resource/assetservice/asset/{assetId}?api_key={key}

Parameters

• eventId (mandatory for the regcenter/event permutation): the id for the event.  this can be parsed from the queryString of the event details web page, i.e. http://www.active.com/page/Event_Details.htm?event_id=1609028.
• assetId (mandatory for the assetservice/assete permutation): the id for the asset (assets are more generic than events - an event is only one asset type).  The assetId is embedded as a meta tag in the event detais HTML.  It is also returned by the Asset Syndication API.
• key (mandatory): the API access key provided by active.com.

Method: GET

Sample Request

http://api.amp.active.com/resource/regcenter/event/1609028?api_key=u2hcu6p5qvwksr54gdz9rppz

http://api.amp.active.com/resource/assetservice/asset/a8799ed2-f44f-427b-9c58-ee30e9766887?api_key=u2hcu6p5qvwksr54gdz9rppz

Sample Response

<event>
<assetID>a8799ed2-f44f-427b-9c58-ee30e9766887</assetID>
<eventID>1609028</eventID>
<eventName>
Callaway Gardens Marathon (USATF certified) A great "Boston" qualifier
</eventName>
<eventDate>2009-01-25T00:00:00-08:00</eventDate>
<eventLocation>
Callaway Gardens Resort Preserve - Robin Lake Beach
</eventLocation>
<eventCity>Pine Mountain</eventCity>
<eventState>Georgia</eventState>
<eventZip>31822</eventZip>
<eventCountry>USA</eventCountry>
<eventDescription>
<b>BRIEF DESCRIPTION:</b><br>  The Marathon and Half Marathon are run on the same course.  One loop for the Half Marathon and two loops for the Marathon.  Run entirely within the resort on the most beautiful course that you'll ever run!  Past the Butterfly Center, Discovery Center, Sibley Horticultural Center, the Chapel, Brothers Azalea Bowl and The Vegtable Garden.  If you've never run at Callaway Gardens you've got a real treat coming to you!<br>

The 5K is around Robin Lake - flat and very fast!<p>



<b>FEES:</b><br>  Marathon - 55.00 by 1/18 - 65.00 thereafter<br>

<p>







<b>CATEGORIES:</b><br>  14-under - 15-19 in five year increments up to 70+ for all three races - male/female<p>





<b>TIME:  </b><br>8:00AM  Marathon & Half Marathon<p>

         



<b>VENUE: </b><br> Callaway Gardens Resort Preserve- Pine Mountain, GA<p>



<b>ADDRESS: </b><br> Pine Mountain, Georgia 31822<p>

<b>CALLAWAY

GARDENS RESORT PRESERVE</b><br>

The 2008 Marathon and Half Marathon is USATF certified.





<b>AWARDS: </b><br> Plaques to top 5 finishers in the Marathon - Long sleeve t-shirts to all finishers<p>



<b>PRE-RACE:</b><br>  Saturday, January 24th - noon to 5PM at the Menaboni Center - Mountain Creek Inn.  Packet Pick-up AND LATE REGISTRATION.

<p>



<b>HOTEL ACCOMMODATIONS:  </b><br>Mountain Creek Inn (host hotel) 800-282-8181 ask for the "Fitness Series" rate.  Other Callaway Gardens accommodations include the new Lodge and Spa @ Callaway, the Cottages and Villas @ Callaway.<p>



<b>DIRECTIONS: </b><br> From Atlanta take I-85 south to I-185.  Take I-185 south to exit 42 (Hwy 27).  Go left on Hwy 27 to Pine Mountain.  Go one mile past Pine Mountain on Hwy 27 to Callaway Gardens on your right.
</eventDescription>
<usatSanctioned>false</usatSanctioned>
<regOnline>true</regOnline>
<eventCloseDate>2009-01-23T21:00:00-08:00</eventCloseDate>
<eventFees>Marathon - 55.00 by 1/18 - 65.00 thereafter</eventFees>
<currencyCode>USD</currencyCode>
<eventTypeID>7</eventTypeID>
<hasEventResults>true</hasEventResults>
<hasMetaResults>true</hasMetaResults>
<showMap>false</showMap>
<eventType>7</eventType>
<eventContactEmail>eventsdj@aol.com</eventContactEmail>
<eventContactPhone>770-565-5208</eventContactPhone>
<channels>
<channel>
<channelName>Running</channelName>
<primaryChannel>true</primaryChannel>
</channel>
<channel>
<channelName>Walking</channelName>
<primaryChannel>false</primaryChannel>
</channel>
</channels>
<metaEvents>
<event>
<assetID>290fbdcc-5cda-4401-955b-8417ea9d7fa2</assetID>
<eventID>1468673</eventID>
<eventName>
Callaway Gardens Marathon  (USATF certified)  A great "Boston" qualifier
</eventName>
<eventDate>2008-01-27T00:00:00-08:00</eventDate>
<eventDetailsPageUrl>
http://www.active.com/page/Event_Details.htm?event_id=1468673	
</eventDetailsPageUrl>
</event>
<event>
<eventID>1370797</eventID>
<eventName>Callaway Gardens Marathon</eventName>
<eventDate>2007-01-28T00:00:00-08:00</eventDate>
<eventDetailsPageUrl>
http://www.active.com/page/Event_Details.htm?event_id=1370797	
</eventDetailsPageUrl>
</event>
<event>
<eventID>1429188</eventID>
<eventName>Callaway Gardens Marathon</eventName>
<eventDate>2007-01-28T00:00:00-08:00</eventDate>
<eventDetailsPageUrl>
http://www.active.com/page/Event_Details.htm?event_id=1429188	
</eventDetailsPageUrl>
</event>
<event>
<eventID>1406099</eventID>
<eventName>Callaway Gardens Marathon</eventName>
<eventDate>2004-02-01T00:00:00-08:00</eventDate>
<eventDetailsPageUrl>
http://www.active.com/page/Event_Details.htm?event_id=1406099	
</eventDetailsPageUrl>
</event>
<event>
<assetID>23d4b32c-8643-438b-bdb7-9d26ce8a059d</assetID>
<eventID>149792</eventID>
<eventName>Callaway Gardens Marathon & Half-Marathon or 5K</eventName>
<eventDate>2000-02-06T00:00:00-08:00</eventDate>
<eventDetailsPageUrl>
http://www.active.com/page/Event_Details.htm?event_id=149792	
</eventDetailsPageUrl>
</event>
</metaEvents>
<eventCategories/>
<eventDetails/>
<eventDonationLinks/>
<eventSanctions/>
<eventUrl>http://www.callawaygardens.com</eventUrl>
<resultsUrl>
http://results.active.com/pages/page.jsp?pubID=3&eventID=1609028
</resultsUrl>
<eventDetailsPageUrl>
http://www.active.com/page/Event_Details.htm?event_id=1609028	
</eventDetailsPageUrl>
<eventContactUrl>
http://www.active.com/event_contact.cfm?event_id=1609028
</eventContactUrl>
</event>

Reviews (future release)

Events (and virtually any asset type for that matter) can be rated and reviewed on active.com (similar to how Yelp works for restaurants).  This API provides programmatic access to read reviews for a given asset.

URL: http://api.amp.active.com/ratingsandreviews/asset/{assetId}?api_key={key}

Parameters

• assetId (mandatory): the id of the asset.
• key (mandatory): the API access key provided by active.com.

Method: GET

Sample Request:

http://api.amp.active.com/ratingsandreviews/asset/175A278B-BFF7-41F0-9CA4-64FD541860DC?api_key=qabux5f7pwywsaf7zvwtdjqb

Sample Response:

<asset>
<avgRating>4.0</avgRating>
<totalRatings>2</totalRatings>
<totalReviews>2</totalReviews>
<hasUserReviewed>false</hasUserReviewed>
−
<reviews>
−
<review>
<attachmentCount>0</attachmentCount>
<body>Was a good turn out.  lots of fun.</body>
<communityID>2523</communityID>
<dateReviewed>2009-03-27T16:51:34.917-07:00</dateReviewed>
<forumThreadID>56512</forumThreadID>
<ID>565052</ID>
<imageCount>0</imageCount>
−
<rating>
<assetID>175a278b-bff7-41f0-9ca4-64fd541860dc</assetID>
<averageRating>4</averageRating>
<dateRated>2009-03-27T23:51:32.957-07:00</dateRated>
<numberOfRatings>2</numberOfRatings>
<rating>4</rating>
<ratingID>4680</ratingID>
<userID>3635c434-09bd-4cab-85a5-a675ee779add</userID>
</rating>
<subject>Re: 2009 Rodes City Run 10K Reviews</subject>
−
<user>
<ausDisplayName>JeremyGThomas</ausDisplayName>
<ausID>3635c434-09bd-4cab-85a5-a675ee779add</ausID>
−
<avatar>
http://community.active.com/people/JeremyGThomas/avatar/48.png
</avatar>
</user>
</review>
−
<review>
<dateReviewed>2009-01-26T23:39:59-08:00</dateReviewed>
−
<rating>
<assetID>175a278b-bff7-41f0-9ca4-64fd541860dc</assetID>
<averageRating>4</averageRating>
<dateRated>2009-01-26T23:39:59.397-08:00</dateRated>
<numberOfRatings>2</numberOfRatings>
<rating>4</rating>
<ratingID>3332</ratingID>
<userID>2d5e8f70-ab80-4283-aa25-47b772902f65</userID>
</rating>
−
<user>
<ausDisplayName>sthakur1</ausDisplayName>
<ausID>2d5e8f70-ab80-4283-aa25-47b772902f65</ausID>
−
<avatar>
http://community.active.com/people/sthakur1/avatar/48.png
</avatar>
</user>
</review>
</reviews>
</asset>

Results (future release)

Returns a list of hyperlinks to results pages for a given event, as well as those for previous occurences of the event.  For example, if the Callaway Gardens Marathon occurred in 2009, 2008 and 2007, a query to get the link for the 2009 results would return that plus those from 2008 and 2007.  Additionally, if the event had "sub-events" meaning is longest distance is marathon, but also had a half marathon and a 10k, links to results for the subevents for each year will also be included.

URL: http://api.amp.active.com/results/event/{eventId}?api_key={key}

Parameters

• eventId(mandatory): unique identifier for the event.  The eventId can be pulled from the URL of the event page.  The URL for the Callaway Gardens Marathon, for example, is http://www.active.com/page/Event_Details.htm?event_id=1609028, and the eventId would be 1609028 in this case.
• key (mandatory): the API access key provided by active.com.

Method: GET

Sample Request:

http://api.amp.active.com/results/event/1609028?api_key=qabux5f7pwywsaf7zvwtdjqb

Sample Response:

<event>
   <eventID>1609028</eventID>
   <years>
      <year>
      <year>2009</year>
      <resultSubs>
         <resultSub>
            <eventID>1609028</eventID>
            <url>http://results.active.com/page/displayNonGru.jsp?pubID=3&rsID=74832
</url>
<name>Callaway Gardens Marathon</name>
<type>xls</type>
<date>2009-01-25T00:00:00-08:00</date>
</resultSub>
</resultSubs>
</year>
<year>
<year>2008</year>
<resultSubs>
<resultSub>
<eventID>1468673</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=51177
</url>
<name>Marathon</name>
<type>txt</type>
<date>2008-01-27T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1468673</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=51179
</url>
<name>Age Groups</name>
<type>txt</type>
<date>2008-01-27T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1468673</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=51181
</url>
<name>5K</name>
<type>txt</type>
<date>2008-01-27T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1468673</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=51182
</url>
<name>5K Age</name>
<type>txt</type>
<date>2008-01-27T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1468673</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=51183
</url>
<name>Half Marathon</name>
<type>txt</type>
<date>2008-01-27T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1468673</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=51184
</url>
<name>Half Marathon Age</name>
<type>txt</type>
<date>2008-01-27T00:00:00-08:00</date>
</resultSub>
</resultSubs>
</year>
<year>
<year>2007</year>
<resultSubs>
<resultSub>
<eventID>1370797</eventID>
<url>
http://results.active.com/pages/searchform.jsp?pubID=3&rsID=33523
</url>
<name>MAR</name>
<type>gru</type>
<date>2007-01-28T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1429188</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=41754
</url>
<name>5K</name>
<type>txt</type>
<date>2007-01-28T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1429188</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=41755
</url>
<name>half</name>
<type>txt</type>
<date>2007-01-28T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1429188</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=41756
</url>
<name>marathon</name>
<type>txt</type>
<date>2007-01-28T00:00:00-08:00</date>
</resultSub>
</resultSubs>
</year>
<year>
<year>2004</year>
<resultSubs>
<resultSub>
<eventID>1406099</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=20718
</url>
<name>age</name>
<type>txt</type>
<date>2004-02-01T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1406099</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=20719
</url>
<name>half</name>
<type>txt</type>
<date>2004-02-01T00:00:00-08:00</date>
</resultSub>
<resultSub>
<eventID>1406099</eventID>
<url>
http://results.active.com/pages/displayNonGru.jsp?pubID=3&rsID=20720
</url>
<name>5K</name>
<type>txt</type>
<date>2004-02-01T00:00:00-08:00</date>
</resultSub>
</resultSubs>
</year>
</years>
</event>

<GeoAddress>  
   <Street>10182 Telesis Ct</Street>  
   <City>San Diego</City>  
   <StateCode>CA</StateCode>  
   <ZipCode>92121-2719</ZipCode>  
   <Latitude>32.901733</Latitude>  
   <Longitude>-117.207844</Longitude>  
   <Precision>address</Precision>  
</GeoAddress>