Campground Details 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 Details API provides a rich set of metadata about a given campground. This includes a detailed description, often authored by park rangers, and a comprehensive list of ammenities.
URL: http://api.amp.active.com/camping/campground/details?{queryString params}&api_key={key}
Method: GET
Sample Request - returns details about Mueller State Park in Colorado
Sample Response
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <detailDescription alert="BEAR ALERT: BLACK BEARS ARE COMMON IN THE PARK. FOOD STORAGE REGULATION STRICTLY ENFORCED! FIRST COME FIRST SERVE CAMPING MAY BE AVAILBLE OUTSIDE THE RESERVATION DATES. CONTACT THE PARK FOR INFORMATION." contractID="CO" description="The Mueller cabins are only reservable through the call center. Mueller State Park is open year round. With its wealth of aspen trees, each season is a delight for photographers and sightseers visiting the park. Over fifty miles of scenic trails invite you to explore the park&#39;s rare beauty. Hiking, camping, mountain biking, horseback riding, snow shoeing, cross country skiing and nature study are the park&#39;s main attractions. Mueller&#39;s 5,121 acres of aspen and conifer forests are home to an abundance of wildlife including black bear, elk, deer, fox, coyotes, & hawks. 132 campsites in seven loops include 110 electrical sites accommodating motor homes, trailers and tents, and 22 walk-in tent only sites. Campsites fees range from $16 - $20. After the middle of October, limited winter campsites are available first come/first serve. For more information, call the park at 719-687-2366." drivingDirection="25 miles west of Colorado Springs on Hwy 24 to Divide. Then 3 1/2 miles south on Hwy 67 to the park entrance." facilitiesDescription="" facility="MUELLER STATE PARK" facilityID="50032" importantInformation=" ATTENTION TENT CAMPERS: When checking site information, tent campers must scroll down and read the "IMPORTANT INFORMATION" which will contain tent size information for that site. Some sites will not accommodate tents. ATTENTION ALL CAMPERS: Mueller is Black Bear country. Proper food storage is required per regulations. IMPORTANT RESERVATION INFORMATION: Mueller&#39;s campsites are on reservations approximately the middle of May through the middle of October. Reservations must be made at least three days in advance of your arrival. Aspen Leaf Annual Pass holders can make discounted reservations online. In addition to the camping fee, a parks pass (annual or daily) is required on all vehicles entering the park. Parks passes are not included in reservation fees. FIRST-COME, FIRST-SERVE CAMPING MAY BE AVAILBLE OUTSIDE THE RESERVATION DATES. CONTACT THE PARK FOR INFORMATION. " latitude="38.8947222" longitude="-105.1794444" nearbyAttrctionDescription="" orientationDescription="" recreationDescription="" reservationUrl="http://www.reserveamerica.com/campsiteSearch.do?contractCode=CO&parkId=50032"> <address city="DIVIDE" country="United States" state="Colorado" streetAddress="P.O. BOX 39" zip="80814"/> <photo url="<img width="180" height="120" src="http://www.reserveamerica.com/photos/small/co_50032_1.jpg""/> <photo url="<img width="180" height="120" src="http://www.reserveamerica.com/photos/small/co_50032_2.jpg""/> <photo url="<img width="180" height="120" src="http://www.reserveamerica.com/photos/small/co_50032_3.jpg""/> <photo url="<img width="180" height="120" src="http://www.reserveamerica.com/photos/small/co_50032_4.jpg""/> <photo url="<img width="180" height="120" src="http://www.reserveamerica.com/photos/small/co_50032_5.jpg""/> <photo url="<img width="180" height="120" src="http://www.reserveamerica.com/photos/small/co_50032_6.jpg""/> <informationLink link="" title=""/> <contact name="Direct Line" number="7196872366"/> <contact name="Ranger Station" number="7196872366"/> <amenity distance="Within Facility" name="Biking"/> <amenity distance="Within Facility" name="Bird Watching"/> <amenity distance="Within Facility" name="Camper Services Bldg"/> <amenity distance="Within Facility" name="Comfort Station"/> <amenity distance="Within Facility" name="Cross Country Skiing"/> <amenity distance="Within Facility" name="Dump Station"/> <amenity distance="Within Facility" name="Firewood Available"/> <amenity distance="Within Facility" name="Fishing"/> <amenity distance="Within Facility" name="Group Campground"/> <amenity distance="Within Facility" name="Hiking"/> <amenity distance="Within Facility" name="Horseback Riding"/> <amenity distance="Within Facility" name="Hunting"/> <amenity distance="Within Facility" name="Interpretitive Programs"/> <amenity distance="Within Facility" name="Laundry Facilities"/> <amenity distance="Within Facility" name="Natural Shade"/> <amenity distance="Within Facility" name="Nature Study Exhibits"/> <amenity distance="Within Facility" name="Parking"/> <amenity distance="Within Facility" name="Photography"/> <amenity distance="Within Facility" name="Picnic Tables"/> <amenity distance="Within Facility" name="Picnicking"/> <amenity distance="Within Facility" name="Playground"/> <amenity distance="Within Facility" name="Proximity To Camp Serv."/> <amenity distance="Within Facility" name="Ranger Station"/> <amenity distance="Within Facility" name="Showers"/> <amenity distance="Within Facility" name="Snow Shoeing"/> <amenity distance="Within Facility" name="Snow Sledding"/> <amenity distance="Within Facility" name="Visitor Center"/> <amenity distance="Within Facility" name="Wildlife Watching Opportunity"/> </detailDescription>
Reserving a Campground
The "fullReservationUrl" should be linked to in order to guide the user to ReserveAmerica.com, Active.com's campground reservation system, to make the campsite reservation. As of now, reservations cannot be realized through the API.
API Parameters
contractCode: STATE, FEDERAL or PRIVATE
"contractCode" is a syonym for contractID, which is what is returned by the Campground Search API. It specifies the jurisdiction for the campground. This parameter must be used in conjuction with parkId.
parkId: Facility ID
"parkId" is a synonym for "facilityID", which is returned by the Campground Search API. It is a unique identifier for the campground. For example, a Campgrounds Search API request for parks in Colorado might return the Mueller State Park as a matching record:
<result contractID="CO" contractType="STATE" facilityID="50032" facilityName="MUELLER STATE PARK" faciltyPhoto="/photos/details/co_50032_1.jpg" latitude="38.8947222" longitude="-105.1794444" sitesWithAmps="Y" sitesWithPetsAllowed="Y" sitesWithSewerHookup="N" sitesWithWaterHookup="N" sitesWithWaterfront="" state="CO"/>
A call to the Campground Details API to get more information about this campground looks like this:
where contractID="CO" is mapped to contractCode=CO, and facilityID="50032" is mapped to parkId=50032.
13 Comments
smcguinness – 14 years ago
Why is contractCode required for results when parkId is provided?
active Admin – 14 years ago
facilityIDs are not universally unique. They are only unique within the context of a contractCode.
Ray Watkins – 14 years ago
Why do I always get the information below (404 page not found) when I use the link constructed as you show above for the reservation page. Yet when I do a search from the ReserverAmerica site it takes me to the correct page using the same link? Is this a scam to get the user to log in?
page not found
404 - Document Not Found
Don't worry (it's our fault - we've moved it).
The page you wanted is just a click or two from here:
•Start at the home page
•Find a place to camp or stay
•Search the map
•Sign-in and check your reservations
Ray Watkins – 14 years ago
Figured it out, the reservation url in the documentation is shown as [http://www.reserveamerica.com/campsiteSearch.do?contractCode=CO&parkId=50032] that seems to fail every time. Even if you click on it in this page. However the following does work;
[http://www.reserveamerica.com/campgroundDetails.do?contractCode=CO&parkId=50032] Note that I've replaced campsiteSearch with campgroundDetails and the urlencoded ampersand (&) with just the ampersand (&). Not sure why it works this way. But it does.
active Admin – 14 years ago
Cool. Let us know if you run into any more issues.
Sofi Software – 13 years ago
The following query:
http://api.amp.active.com/camping/campground/details?contractCode=CA&parkId=120039&api_key=2chxq68efd4azrpygt5hh2qu
Returns a reservation url:
reservationUrl="http://localhost/campsiteSearch.do?contractCode=CA&parkId=120039&cmp=10-1"
A url that points to localhost isn't going to succeed...
active Admin – 13 years ago
Well, that's just embarrassing. I've got engineering on it. Stay tuned for an update to the API.
melitele – 12 years ago
When I use my api_key for Campground API I get a different result then with the example api_key: both fullReservationUrl and reservationUrl point to http://www.tantracking.com/click.track followed parameters containing my Active affilite ID.
Both urls get the response "403 - Error AFID not allowed"...
What api_key should I use to get valid reservation urls?
jarredd – 12 years ago
Hi Melitele,
It looks like your affiliate account was not yet setup to run this Campgrounds API campaign (CID 177360) in the Affiliate Center and this caused the issue. However, I have updated your account status so you should now see this campaign in your affiliate center after logging in and clicking the “My Offers” section.
If you are still having trouble, please let me know.
Best regards,
Jarred
Technical Account Manager, ACTIVE Network
Natasha Japp – 10 years ago
Hi, I have generated my link to a Campground Detail, and have the API link with my key code. How do I place that into my WordPress blog? Now if I place it in Firefox, it is an ugly xml file. And in Safari, it does not even show a content, just a blank page. Ideas?
Keith Davis – 8 years ago
This URL gives a site cannot be reached error: http://api.amp.active.com/camping/campground/details?contractCode=CO&parkId=50032&api_key=XXXXXXXXXXXXXXX
Keith Davis – 8 years ago
Problem solved, switched to a different REST client to test the API calls.
Akira – 5 years ago
This works (NOT https) http://api.amp.active.com/camping/campground/details?contractCode=CO&parkId=50032&api_key=XXXXXXXXXXXXXXX
This fails (the same URL as above but it's https) https://api.amp.active.com/camping/campground/details?contractCode=CO&parkId=50032&api_key=XXXXXXXXXXXXXXX
I get this error with https: net::ERR_CONTENT_DECODING_FAILED 200
New comments are not being accepted at this time.