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

The following query shows campgrounds in California with fishing:

http://api.amp.active.com/camping/campgrounds?pstate=CA&amenity=4004&api_key=2chxq68efd4azrpygt5hh2qu

eqplen: Equipment Length

If the camper wants to find campgrounds where his 50 foot RV will fit, issue a query where eqplen=50:

http://api.amp.active.com/camping/campgrounds?pstate=CA&eqplen=50&api_key=2chxq68efd4azrpygt5hh2qu

Maxpeople: Number of campers

Looking for campgrounds with sites that will fit up to 8 people?

http://api.amp.active.com/camping/campgrounds?pstate=CA&Maxpeople=8&api_key=2chxq68efd4azrpygt5hh2qu

hookup: Electric Hookup

15 Amps or More 3002
20 Amps or More 3003
30 Amps or More 3004
50 Amps or More 3005

Here's an example for campgrounds in California with sites with 30 Amp hookups that will fit an RV of 50 feet in length:

http://api.amp.active.com/camping/campgrounds?pstate=CA&eqplen=50&hookup=3004&api_key=2chxq68efd4azrpygt5hh2qu

water: Water Hookup

Specify &water=3007 to search for campgrounds with water hookups.

http://api.amp.active.com/camping/campgrounds?pstate=CA&water=3006&api_key=2chxq68efd4azrpygt5hh2qu

sewer: Sewer Hookup

Specify &sewer=3007 to search for campgrounds with sewer hookups.

http://api.amp.active.com/camping/campgrounds?pstate=CA&sewer=3007&api_key=2chxq68efd4azrpygt5hh2qu

pull: Pull Through Driveway

Specify &pull=3008 to search for campgrounds with pull through driveways.

http://api.amp.active.com/camping/campgrounds?pstate=CA&pull=3008&api_key=2chxq68efd4azrpygt5hh2qu

pets: Pets Allowed

Specify &pets=3010 to search for campgrounds where pets are allowed.

http://api.amp.active.com/camping/campgrounds?pstate=CA&pets=3010&api_key=2chxq68efd4azrpygt5hh2qu

waterfront: Waterfront Sites

Specify &waterfront=3011 to search for campgrounds with waterfront campsites.

http://api.amp.active.com/camping/campgrounds?pstate=CA&waterfront=3011&api_key=2chxq68efd4azrpygt5hh2qu

Brand Guidelines

Let's Talk

22 Comments

  1. smcguinness7 years ago

    Is it possible to add city to the information returned in this search API?

  2. active Admin7 years ago

    Many campgrounds are outside city borders, so I'm not sure that this would always make sense. Thoughts?

  3. Paul G5 years ago

    Is there a way to limit the number of results returned? Let's say I want to get 10 closest to a geo location - is it possible? Sure, I can read the stream result by result and close it when I got enough but it doesn't seem to be a clean way.

  4. jarredd5 years ago

    Hi Paul,

    No, there’s no parameter to limit the number of results returned. This function must be implemented on your end.

    Best regards,

    Jarred

    Technical Account Manager, ACTIVE Network

  5. alyssa5 years ago

    for the landmarkLat/Long query - what exactly does 'close' mean? Is there any way to request different distances from the landmark? (ex: 25 miles, 100 miles) Thank you!

  6. jarredd5 years ago

    The search radius is 200 miles for the landmark/latlong query.

  7. alyssa5 years ago

    awesome, thank you jarredd!! you are all over it, appreciate your help.

  8. alyssa5 years ago

    awesome, thank you jarredd!! you are all over it, appreciate your help.

  9. marylee5 years ago

    Hello I am confused by the results this API returns. Isn't the purpose of this API to only return campgrounds that are available for the queries for provided? If so, why do many of the results I am receiving have an availabilityStatus of 'N' ? This is even happening in your example.

  10. marylee5 years ago

    Hello I am confused by the results this API returns. Isn't the purpose of this API to only return campgrounds that are available for the queries for provided? If so, why do many of the results I am receiving have an availabilityStatus of 'N' ? This is even happening in your example.

  11. jarredd5 years ago

    The API returns results for all campgrounds and allows you to show (or not show) the campground on your end based on availability. If 'Y' show as available, if 'N' show as unavailable.

  12. marylee5 years ago

    oh, ok. thank you for the quick reply! can I get the results in JSON?

  13. marylee5 years ago

    oh, ok. thank you for the quick reply! can I get the results in JSON?

  14. jarredd5 years ago

    Currently, this API only returns XML results.

  15. marylee5 years ago

    any estimate on when JSON will be available? i dont know how to work with XML results :*(

  16. jarredd5 years ago

    We do not have this on the roadmap for the year. I will post an update if anything changes, but the ReserveAmerica team is focusing on other priorities and will likely not be adding in JSON results to the API any time soon.

  17. gduan20003 years ago

    i registered, received 4 keys but no campground api key.

  18. Smoot1 year ago

    Confused. All campgrounds always have no availability. One would like to use this API to find & present options to a user so they can book on RA.com, but it doesnt seem possible. or really very useful at all. also as far as I can tell the lat/long part is broken since I get from FL to NY to CA with a request to be near a point in CA

  19. manik9 months ago

    I can't seem to get any availability info on anything I search for either. Is this feature broken?

  20. Mohit Chawla9 months ago

    Hi team, Any way to get all campgrount between lat/lng of two locations.

  21. gena3 months ago

    hi, can i get this in json format please?

  22. astarnes3 months ago

    There currently aren't plans to add JSON results to the API.

Please sign in to post a comment.