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:
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):
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:
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:
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.
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 – 11 years ago
awesome, thank you jarredd!! you are all over it, appreciate your help.
alyssa – 11 years ago
awesome, thank you jarredd!! you are all over it, appreciate your help.
marylee – 11 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 – 11 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 – 11 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 – 11 years ago
oh, ok. thank you for the quick reply! can I get the results in JSON?
marylee – 11 years ago
oh, ok. thank you for the quick reply! can I get the results in JSON?
jarredd – 11 years ago
Currently, this API only returns XML results.
marylee – 11 years ago
any estimate on when JSON will be available? i dont know how to work with XML results :*(
jarredd – 11 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.