ReserveAmerica.com

[ctrl-brk]

Add support for reserveamerica.com

[juftin]

I've had my eye on reserveamerica.com for some time now. The issue with implementing it as a camply provider is they don't have a public facing RESTful API powering their site.

All current camply providers, like recreation.gov, use a RESTful API. So a campground like Cold Springs - Arapaho Roosevelt NF (CO)
has its own API endpoint that returns JSON: GET https://www.recreation.gov/api/media/public/asset/231856. Camply works by reverse engineering these APIs so we can search for campgrounds and ask about their availability.

reserveamaerica.com is a bit more high tech than most providers and doesn't surface an API and instead handles all of this on the backend to render HTML for the front end.

So a provider like ReserveAmerica could work with camply but it would require that camply scrapes the sites's HTML to get data instead of pinging their API. I'm not saying I won't ever implement this but it would require a bunch of work and a new approach for the tool.

[mr1716]

There is an older API for Reserve America: Third Party API

But it doesn’t show availability information and I think is no longer supported/updated. Plus don’t think it provides what is desired.

[mr1716]

@juftin there looks to be an API: https://api.reserveamerica.com/ and https://chub.api.reserveamerica.com/, but unsure its use or if available

[thisIsMikeKane]

@ctrl-brk , @thornto4 , and @mr1716 would you be interested in helping with PR #369 ?

[beege]

I believe I've found information about the internal reserve america api. I've been able to make requests without captcha accessing the restful interface of api.reserveamerica.com and get JSON availability data back - similar to the smartphone app does. Code is just in the research preliminaries now but I'll look at what you have here as I have time and maybe integrate that.

[mr1716]

@beege, how did you do that? Will you be posting your code somewhere as part of a project?

[beege]

Not sure what I'll release yet. Might just be a simple POC. After further research I found that it does not work for everything on the reserveamerica website, but only for what the smartphone app supports. There are some (many?) campgrounds in the reserve america app that redirect you to use a browser on reserveamerica webpage instead (I think that's the "chub" API mentioned above). And the queries I get back for those are not useful - there's just a dummy placeholder. - I wonder if those perhaps still work with the ACTIVE API mentioned previously (https://developer.active.com/docs/read/Campsite_Search_API) - but I haven't checked. That API still (sort of) works but I gave up on that initially because it didn't support availability data for the state parks I was interested in. I made the assumption that it doesn't have any availability data anymore but that could be false since I wasn't checking "chub" campgrounds.

Anyway, lots of state parks work with the internal API I found. I'll probably make a short POC for a random state park and release that. I don't spend much time coding these days but I'll get to it soon.

[mr1716]

@beege, the API lacks the Availability data. One way that I was considering was using a browser like selenium, get an AWS key, and then do parsing of the sites. But that’s a lot of work and not exactly scalable or easy

[beege]

@mr1716 The public API does indeed lack the availability data, but the private API, used by the reserve america app doesn't. You probably think I'm full of crap since I posted that and haven't followed up. Apologies for the late response, I meant to work on this more but haven't had the motivation. I used to work in tech but retired a few years ago and now spend more time outdoors than on the computer.

Anyway I started to make a repo for this but the POC is short enough I can just post it as part of this comment. Do with it what you will. Merry Christmas. I've tested this for a few states and it seems to work just fine but with the limitations I mentioned in my previous comment.

import requests
import urllib
import json

headers = None
#Note: None for headers - works for signin, but might want to spoof the client if you're making lots of requests... - there's actually an API to get the current version which I haven't documented but could provide later... or just check google play
#headers = {
#     "Ao-Requestclient": "RA Camping_4.20.0.3_Android_ALL",
#}


# first go to /signin to get cookie
r = requests.get("https://www.reserveamerica.com/signin", headers=headers)
signinCookies = r.cookies

# Setup the next request
cookies = {
    "Authorization" : signinCookies["idToken"],
    "A1Data" : signinCookies["a1Data"],
}

# then do query using cookies
headers = {
    "Authorization" : signinCookies["idToken"],
    "A1Data" : urllib.parse.unquote(signinCookies["a1Data"]),
    
    # These don't seem to be needed
    #"Privatekey": "ar568sda35f8a1e3dwra89da99asdtasdf68asdgf51r",
    #"Ao-Requestclient": "RA Camping_4.20.0.3_Android_ALL",
    #"User-Agent" : "User-Agent: Dalvik/2.1.0 (Linux; U; Android 13; xxxxx); Mobile", # Fill in a mobile-looking UA here
}

# Limitations of API: only works with things you can book using the reserve america app. Places that the app links to the browser to book instead do not work. 
# This is similar to the old style of rec.gov I think - get the state (aka "contract"), campground id and individual campsites.

# EXAMPLE: Ainsworth State Park, OR (Facility 409402)

# Get any campsites avaialble at the facility 409402 on or after 2026-01-01 with one night length of stay
r = requests.get("https://api.reserveamerica.com/jaxrs-json/products/OR/409402/campsites?displayGISMap=false&rcp=0&next=true&fc=false&arv=2026-01-01&lsy=1", headers=headers, cookies=cookies)

# To just check a single campsite you can add an argument like: &prdId=xxxx where xxxx is the campsite #

data = json.loads(r.text)

for record in data["records"]:
    print(record["name"])
    for grid in record["availabilityGrid"]:
        print("\t",grid["date"], record["bookingStatus"])

[mr1716]

@beege, all good. Stud happens and we get busy. Been too busy myself, so understood. Not mad. Just curious where things went