Campground Search API

TYPES OF DATA AVAILABLE

Campgrounds: US and Canada's national and state/provincial parks, campgrounds, and campsites.

Request Limits

Campgrounds API Key APPLY FOR A KEY

· Active - Upon registration

· Throttle Rate - 2 calls per second

· Quota Limit – 5,000 calls per day

The Campground Search API processes HTTP GET requests and returns results in XML format. It is designed to return campground data matching a set of filters, such as state, name, features (fishing, hunting, golf), and ammenities (RV friendly, electricity, hunting, fishing). This API searches metadata from 97% of the national and state parks in the United States and Canada.

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

Sample Request - return all campgrounds in Colorado with RV hookups, a golf course and pets allowed:

http://api.amp.active.com/camping/campgrounds?pstate=CO&siteType=2001&expwith=1&amenity=4005&pets=3010&api_key=2chxq68efd4azrpygt5hh2qu

Sample Response

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<resultset amenity="4005" count="7" lengthOfStay="5" pstate="CO" 
 resultType="campgrounds" siteType="2001">
   <result contractID="KOA" contractType="PRIVATE" 
    facilityID="191502" facilityName="Alamosa KOA" 
    faciltyPhoto="/photos/details/koa_191502_1.jpg" 
    latitude="37.4744444" longitude="-105.7986111" sitesWithAmps="Y" sitesWithPetsAllowed="Y" 
    sitesWithSewerHookup="N" sitesWithWaterHookup="Y" sitesWithWaterfront="" state="CO"/>
   <result contractID="KOA" contractType="PRIVATE" 
    facilityID="190902" facilityName="Cotopaxi / Arkansas River KOA" 
    faciltyPhoto="/photos/details/koa_190902_1.jpg" 
    latitude="38.3783333" longitude="-105.6675" sitesWithAmps="Y" sitesWithPetsAllowed="Y" 
    sitesWithSewerHookup="N" sitesWithWaterHookup="Y" sitesWithWaterfront="" state="CO"/>
   <result contractID="KOA" contractType="PRIVATE" 
    facilityID="190308" facilityName="Cripple Creek / Colorado Springs W. KOA" 
    faciltyPhoto="/photos/details/koa_190308_1.jpg" 
    latitude="38.7744444" longitude="-105.1175" sitesWithAmps="Y" sitesWithPetsAllowed="Y" 
    sitesWithSewerHookup="N" sitesWithWaterHookup="Y" sitesWithWaterfront="" state="CO"/>
   <result contractID="KOA" contractType="PRIVATE" 
    facilityID="193652" facilityName="Gunnison KOA" 
    faciltyPhoto="/photos/details/koa_193652_1.jpg" 
    latitude="38.5308333" longitude="-106.9452778" sitesWithAmps="Y" sitesWithPetsAllowed="Y" 
    sitesWithSewerHookup="N" sitesWithWaterHookup="Y" sitesWithWaterfront="" state="CO"/>
   <result contractID="KOA" contractType="PRIVATE" 
    facilityID="190306" facilityName="Limon KOA" 
    faciltyPhoto="/photos/details/koa_190306_1.jpg" 
    latitude="39.2647222" longitude="-103.6730556" sitesWithAmps="Y" sitesWithPetsAllowed="Y" 
    sitesWithSewerHookup="N" sitesWithWaterHookup="Y" sitesWithWaterfront="" state="CO"/>
   <result contractID="KOA" contractType="PRIVATE" 
    facilityID="190305" facilityName="Royal Gorge / Canon City KOA" 
    faciltyPhoto="/photos/details/koa_190305_1.jpg" 
    latitude="38.4902778" longitude="-105.3286111" sitesWithAmps="Y" sitesWithPetsAllowed="Y" 
    sitesWithSewerHookup="N" sitesWithWaterHookup="Y" sitesWithWaterfront="" state="CO"/>
   <result contractID="NRSO" contractType="FEDERAL" 
    facilityID="70685" facilityName="PAINTED ROCKS (CO)" 
    faciltyPhoto="/photos/details/nrso_70685_1.jpg" 
    latitude="39.0844444" longitude="-105.1052778" sitesWithAmps="N" sitesWithPetsAllowed="N" 
    sitesWithSewerHookup="N" sitesWithWaterHookup="N" sitesWithWaterfront="" state="CO"/>
</resultset>

Note, the "facilityPhoto" can be retrieved by prepending "http://www.reserveamerica.com" in front of it. For example, the photo for the first result, where facilityPhoto="/photos/details/koa_191502_1.jpg", can be downloaded at http://www.reserveamerica.com/photos/details/koa_191502_1.jpg. However, as a known limitation not all results have downloadable photos despite the fact that they have a facilityPhoto value. As such, the developer will have to attempt to retrieve the photo and not display it when a 404 is returned.

API Parameters

landmarkLat, landmarkLong (latitude/longitude)

These two parameters allow for campground searches around a fixed geo-point. For example, the following returns a list of campgrounds close to Kirby Cove Campground (near San Francisco):

http://api.amp.active.com/camping/campgrounds?landmarkName=true&landmarkLat=37.84035&landmarkLong=-122.4888889&xml=true&api_key=2chxq68efd4azrpygt5hh2qu

The developer will have to convert the geo-point into latitude and longitude with another system, such as the Google Geocoding API. Also, the "landmarkName=true" parameter/value must be supplied when doing this query. Results are sorted by distance from the geo-point, with the closest campground being the first result.

siteType

If unspecified, all site types are returned.

RV Sites	2001
Cabins or Lodgings	10001
Tent	2003
Trailer	2002
Group Site	9002
Day Use	9001
Horse Site	3001
Boat Site	2004

pstate: State or Province

The two character abbreviation for US state (http://www.usps.com/ncsc/lookups/usps_abbreviations.html), Canadian province or territory (http://canadaonline.about.com/library/bl/blpabb.htm).

pname: Park Name

The name of the park. When this parameter is specified, the API performs a string-match query for parks containing the character string specified. For example, the following query returns all campgrounds containing the word "ASPEN", http://api.amp.active.com/camping/campgrounds?pname=ASPEN&api_key=2chxq68efd4azrpygt5hh2qu.

amenity: Campground Feature

There are all sorts of things to do at campgrounds. Specifying amenity=4004, for example, returns campgrounds with fishing. Only one amenity can be specified per query. The following is a list of valid amenity codes:

Biking	4001
Boating	4002
Equipment Rental	4003
Fishing	4004
Golf	4005
Hiking	4006
Horseback Riding	4007
Hunting	4008
Recreational Activities	4009
Scenic Trails	4010
Sports	4011
Beach/Water Activities	4012
Winter Activities	4013