parks

Get Site Reviews

One site's guest reviews, verbatim, newest first by default.

For PERMITS this is a surface Recreation.gov does not have: their page lists a permit's reviews as one undifferentiated stream and publishes no division id, so a user comparing two entry points has a score and nothing to read behind it. Every review still names the place it was written about, so the split exists in their data and is simply never shown.

For CAMPGROUNDS they already show reviews per campsite — which is why the harvester gets an exact campsite_id join there. This route is not uncovering anything on that surface, only putting it in the card.

Offset paging rather than a keyset cursor: the deterministic ORDER BY makes it stable, the page is capped, and a review list is short enough that the offset never walks far. A keyset would need the sort key echoed back and gains nothing at this size.

Unrated sites return an empty list, not a 404 — a site with no reviews is an ordinary answer, and the card asks before it knows.

get/api/v1/parks/sites/{site_id}/reviews

Request

  • Base URL: https://api.alert.camp (the document declares no server; this is the origin it was published from)
  • URL: https://api.alert.camp/api/v1/parks/sites/{site_id}/reviews
  • Auth: none declared

Path parameters

site_idstring required

Query parameters

sortstring

recent | rating_desc | rating_asc

cursorinteger

Rows already shown

limitinteger

Response

Successful Response

site_idstring required
totalinteger required

Every review we hold for this site.

next_cursorinteger nullable

Pass back as cursor for the next chunk; null at the end of the list, which is how the client knows to stop asking rather than inferring it from a short page.

Changes

No recorded changes to this operation across all 1 revision of this API.