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

version 32 as of 1 year ago by mzhang

29 Comments

smcguinness – 14 years ago

Is it possible to add city to the information returned in this search API?
active Admin – 14 years ago

Many campgrounds are outside city borders, so I'm not sure that this would always make sense. Thoughts?
Paul G – 12 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.
jarredd – 12 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
alyssa – 12 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!
jarredd – 12 years ago

The search radius is 200 miles for the landmark/latlong query.
alyssa – 12 years ago

awesome, thank you jarredd!! you are all over it, appreciate your help.
alyssa – 12 years ago

awesome, thank you jarredd!! you are all over it, appreciate your help.
marylee – 12 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.
marylee – 12 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.
jarredd – 12 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.
marylee – 12 years ago

oh, ok. thank you for the quick reply! can I get the results in JSON?
marylee – 12 years ago

oh, ok. thank you for the quick reply! can I get the results in JSON?
jarredd – 12 years ago

Currently, this API only returns XML results.
marylee – 12 years ago

any estimate on when JSON will be available? i dont know how to work with XML results :*(
jarredd – 12 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.
gduan2000 – 10 years ago

i registered, received 4 keys but no campground api key.
Smoot – 8 years 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
manik – 8 years ago

I can't seem to get any availability info on anything I search for either. Is this feature broken?
Mohit Chawla – 8 years ago

Hi team, Any way to get all campgrount between lat/lng of two locations.
gena – 7 years ago

hi, can i get this in json format please?
astarnes – 7 years ago

There currently aren't plans to add JSON results to the API.
Equinetravels – 7 years ago

Is there any way to get a return results set based on city and state? I see state is available but don't see anything for city
BikeMRH – 6 years ago

Not having any luck with the links on this page. They don't display results. I am using this link in my code to just generate a list of campgrounds in FL. https://api.amp.active.com/camping/campgrounds?pstate=FL&api_key=43XJV3X7FECQ624BKMH7W9MB
activePaul – 6 years ago

In the sample request it uses expwith = 1. What is expwith? http://api.amp.active.com/camping/campgrounds?pstate=CO&siteType=2001&expwith=1&amenity=4005&pets=3010&api_key=2chxq68efd4azrpygt5hh2qu
Manisha Singh – 5 years ago

http://api.amp.active.com/camping/campgrounds/?pstate=ab&siteType=2001&Maxpeople=6&api_key=<key> doesnt return list/details of all the campsites. Is it broken. Anybody had luck?
Akira – 5 years ago

http://api.amp.active.com/camping/campgrounds/?pstate=ab&siteType=2001&Maxpeople=6&api_key=<key> I can't get any data back from API either. I think it's broken too
wlvrn – 5 years ago

The parameter "water" is 1) documented incorrectly. It says use 3007 but in the example, it uses 3006. Which is it? Well, neither actually work. Use of 3006 or 3007 as a value for the water parameter result in a mixed result of sites that have water hookup availability. Do you guys write tests or QA this?
wlvrn – 5 years ago

Actually, a lot is broken. Water, sewer, most of the filter actions are returning broken results. Searching by pname and pstate does work though. Looks like this is abandoned.

New comments are not being accepted at this time.

Campground Search API

TYPES OF DATA AVAILABLE

Request Limits

Brand Guidelines

Let's Talk

29 Comments

Jarred

Docs Navigation

Follow Active

Other Resources

Active Network