AllTrails park or place with its trails API

Use the AllTrails park or place with its trails API to retrieve route descriptions, geographic coordinates, record identities and titles, source-page links and geographic references as structured JSON from AllTrails. Supply source-page URL in the query; optionally select search words to set the requested scope. Use these results to compare route characteristics and organize trail reference material when planning an outdoor itinerary. The documented source-page link form identifies the requested entry directly and lets you reuse an existing source-page reference. Continue with the returned next_page as page; a null value marks the last page. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.

Selected price
$0.002 / billing creditPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Place link or path, e.g. `parks/us/california/yosemite-national-park`, `us/california/yosemite-valley`, `us/california`, `poi/us/colorado/estes-park/emerald-lake`; or a park id.
Optional parameters (19)
Keywords to narrow the place's trails.
easy, moderate, hard, strenuous; comma separated for several.
Shortest trail length in kilometres.
Longest trail length in kilometres.
Least elevation gain in metres.
Most elevation gain in metres.
loop, out_and_back, point_to_point; comma separated.
Any of these activities, comma separated: hiking, walking, trail-running, mountain-biking, road-biking, backpacking, camping, birding, fishing, horseback-riding, rock-climbing, skiing, cross-country-skiing, snowshoeing, scenic-driving, paddle-sports, off-road-driving, via-ferrata.
Features every trail must have, comma separated: dogs, dogs-leash, dogs-no, kids, ada, strollers, paved, partially-paved, views, waterfall, lake, river, beach, forest, cave, wild-flowers, wildlife, hot-springs, historic-site, rails-trails, city-walk.
Least average rating (0-5).
`true`: leave out closed trails.
Trails in this park (id from /alltrails/v1/places or a trail's `park`).
Page (default 1). Pass `next_page` back as `page`; null on the last page. The site lists at most 1,000 results per search.
Results per page (default 24, max 100).
0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
1 skips the 24-hour cache and fetches live.
JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.
With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.

Sample response

"bounds": {
  "northeast": {
    "lat": 38.1863499,
    "lng": -119.1995075
  },
  "southwest": {
    "lat": 37.4921493,
    "lng": -119.8861599
  }
}
"cached": false
"country": {
  "id": 313,
  "name": "United States"
}
"credits_used": 1
"curated_lists": null
"fetched_at": "2026-11-19T12:28:30.526Z"
"guides": [
  {
    "ID": 121,
    "background_color": "#221511",
    "name": "Top Picks in Yosemite National Park",
    "name_with_formatting": "<em>Top Picks</em> in Yosemite National Park",
    "objectID": "guide-121",
    "photo_url": "https://www.alltrails.com/api/alltrails/guides/121/profile_photo",
    "slug": "guides/us/california/top-picks-in-yosemite-national-park",
    "topic": "top_picks",
    "trail_count": 8,
    "type": "guide"
  },
  {
    "ID": 122,
    "background_color": "#161f13",
    "name": "Hidden Gems in Yosemite National Park",
    "name_with_formatting": "<em>Hidden Gems</em> in Yosemite National Park",
    "objectID": "guide-122",
    "photo_url": "https://www.alltrails.com/api/alltrails/guides/122/profile_photo",
    "slug": "guides/us/california/hidden-gems-in-yosemite-national-park",
    "topic": "hidden_gems",
    "trail_count": 5,
    "type": "guide"
  },
  {
    "ID": 119,
    "background_color": "#6D4E1E",
    "name": "Backpacking Trips in Yosemite National Park",
    "name_with_formatting": "<em>Backpacking Trips</em> in Yosemite National Park",
    "objectID": "guide-119",
    "photo_url": "https://www.alltrails.com/api/alltrails/guides/119/profile_photo",
    "slug": "guides/us/california/backpacking-trips-in-yosemite-national-park",
    "topic": "activities",
    "trail_count": 3,
    "type": "guide"
  },
  {
    "ID": 120,
    "background_color": "#2F2312",
    "name": "Family-Friendly Day Hikes from Yosemite Valley Campgrounds",
    "name_with_formatting": "<em>Family-Friendly Day Hikes</em> from Yosemite Valley Campgrounds",
    "objectID": "guide-120",
    "photo_url": "https://www.alltrails.com/api/alltrails/guides/120/profile_photo",
    "slug": "guides/us/california/family-friendly-day-hikes-from-yosemite-valley-campgrounds",
    "topic": "activities",
    "trail_count": 4,
    "type": "guide"
  }
]
"id": 10106838
"kind": "area"
"latitude": 37.8482617
"location": "California, United States"
"longitude": -119.5568839
"name": "Yosemite National Park"
"next_page": 2
"object_id": "area-10106838"
"page": 1
"park_type": "National Park"
"poi_count": 694
"popularity": 134.9988
"slug": "parks/us/california/yosemite-national-park"
"state": {
  "id": 5,
  "name": "California"
}
"trail_activities": [
  "hiking",
  "trail-running",
  "backpacking",
  "camping",
  "horseback-riding",
  "cross-country-skiing",
  "snowshoeing",
  "rock-climbing",
  "via-ferrata",
  "walking",
  "fishing",
  "running",
  "mountain-biking",
  "road-biking",
  "birding"
]
"trail_difficulties": [
  "moderate",
  "strenuous",
  "hard",
  "easy"
]
"trail_features": [
  "forest",
  "kids",
  "river",
  "views",
  "wild-flowers",
  "wildlife",
  "dogs-no",
  "lake",
  "waterfall",
  "ada",
  "cave",
  "dogs-leash",
  "partially-paved",
  "strollers",
  "historic-site",
  "paved",
  "beach",
  "dogs"
]
trails {}
"applied_filters": {}
"count": 1
items [1]
[0] {}
"activities": [
  "hiking",
  "trail-running"
]
"alert_ids": [
  171,
  20017,
  20019
]
"city": {
  "id": 1036,
  "name": "Yosemite Valley",
  "url": "https://www.alltrails.com/us/california/yosemite-valley"
}
"closed": false
"collections": [
  "trending",
  "waterfalls",
  "views",
  "trees",
  "rivers",
  "wildflowers"
]
"country": {
  "id": 313,
  "name": "United States"
}
"created_at": "2020-02-21T22:28:26.000Z"
descriptionString · text preview
trails.items[0].description
Hike to two breathtaking waterfalls along some of Yosemite Valley's most popular hiking trails. If you only have time for one hike while in Yosemite, look no further - the Mist Trail is the hike for you. It is no wonder that this trail is one of the most traveled in Yosemite National Park. You will hike so close to these two massive waterfalls that you may get wet from the trail. The best time to hike this trail is in Spring or early Summer, while the snow runoff is high and the falls are full of water.

The Mist Trail starts at Happy Isles Trailhead (YARTS Happy Isles shuttle stop #16, and is within walking distance of Curry Village and the parking lot). The park recommends starting early to avoid the larger crowds. After a brief stroll along the river, you climb a pretty steep initial ascent over stone steps until you reach the footbridge, which offers the first glimpse of Vernal Falls in the distance. You will also find a water fountain and restrooms. You will then continue up to Vernal Falls, past Emerald Pool, and alongside Nevada Falls until you reach the high point of this hike.

You can choose to take the alternate route down along the John Muir Trail to see great views of Nevada Falls and Liberty Cap in the distance before meeting back up with the Mist Trail near the footbridge. This route back is slightly longer, but offers a change of scenery and is easier on the knees. Before hopping back on the YARTS shuttle, treat yourself to some ice cream or a refreshing drink at the small stand, or head over to Curry Village for a wider selection.

In the 19th century, Yosemite National Park was served by Buffalo Soldiers, former Black regiments of the US Army. These men became the first Black national park rangers and backcountry rangers and were tasked with fighting fires, preventing poaching, and helping create the trails that millions of people explore each year.
"difficulty": "hard"
"difficulty_rating": 5
"elevation_gain_ft": 2070
"elevation_gain_m": 631
"features": [
  "forest",
  "river",
  "views",
  "waterfall",
  "wild-flowers",
  "wildlife",
  "dogs-no",
  "partially-paved"
]
"highest_point_m": 1827
"id": 10026910
"latitude": 37.73282
"length_km": 10.94
"length_m": 10944
"length_mi": 6.8
"location": "Yosemite National Park, California"
"longitude": -119.55778
"monthly_popularity": {
  "month_1": 311,
  "month_10": 2656,
  "month_11": 1384,
  "month_12": 352,
  "month_2": 299,
  "month_3": 676,
  "month_4": 2101,
  "month_5": 4647,
  "month_6": 4465,
  "month_7": 3912,
  "month_8": 4040,
  "month_9": 3330
}
"name": "Vernal and Nevada Falls via Mist Trail"
"park": {
  "id": 10106838,
  "name": "Yosemite National Park",
  "url": "https://www.alltrails.com/parks/us/california/yosemite-national-park"
}
"photo": "https://images.alltrails.com/eyJidWNrZXQiOiJhc3NldHMuYWxsdHJhaWxzLmNvbSIsImtleSI6InVwbG9hZHMvcGhvdG8vaW1hZ2UvMTI3MDcyMjg2LzNkNDMyZGUwYzNiMzc3NjE0OTA3NDg3NDg4YTkxODk1LmpwZyIsImVkaXRzIjp7InRvRm9ybWF0IjoianBlZyIsInJlc2l6ZSI6eyJ3aWR0aCI6MTIwMCwiaGVpZ2h0IjoxMjAwLCJmaXQiOiJpbnNpZGUifX19"
"photos": 89518
"popularity": 99.9988
"private_property": false
"rating": 4.9
"recordings": 42807
"reviews": 27900
"route_type": "loop"
"slug": "trail/us/california/vernal-and-nevada-falls-via-the-mist-trail"
"state": {
  "id": 5,
  "name": "California"
}
"text_reviews": 6229
"url": "https://www.alltrails.com/trail/us/california/vernal-and-nevada-falls-via-the-mist-trail"
"visitor_usage": 4
"limit": 1
"next_page": 2
"page": 1
"total": 309
"trails_count": 331
"type_label": "National Park"
"url": "https://www.alltrails.com/parks/us/california/yosemite-national-park"

Response result

Response structure

Inferred from examples
  • boundsobject
    • northeastobject
      • latnumber
      • lngnumber
    • southwestobject
      • latnumber
      • lngnumber
  • cachedboolean
  • countryobject
    • idinteger
    • namestring
  • credits_usedinteger
  • curated_listsnull
  • fetched_atstring
  • guidesobject[]
    • IDinteger
    • background_colorstring
    • namestring
    • name_with_formattingstring
    • objectIDstring
    • photo_urlstring
    • slugstring
    • topicstring
    • trail_countinteger
    • typestring
  • idinteger
  • kindstring
  • latitudenumber
  • locationstring
  • longitudenumber
  • namestring
  • next_pageinteger
  • object_idstring
  • pageinteger
  • park_typestring
  • poi_countinteger
  • popularitynumber
  • slugstring
  • stateobject
    • idinteger
    • namestring
  • trail_activitiesstring[]
  • trail_difficultiesstring[]
  • trail_featuresstring[]
  • trailsobject
    • applied_filtersobject
    • countinteger
    • itemsobject[]
      • activitiesstring[]
      • alert_idsinteger[]
      • cityobject
        • idinteger
        • namestring
        • urlstring
      • closedboolean
      • collectionsstring[]
      • countryobject
        • idinteger
        • namestring
      • created_atstring
      • descriptionstring
      • difficultystring
      • difficulty_ratinginteger
      • elevation_gain_ftinteger
      • elevation_gain_minteger
      • featuresstring[]
      • highest_point_minteger
      • idinteger
      • latitudenumber
      • length_kmnumber
      • length_minteger
      • length_minumber
      • locationstring
      • longitudenumber
      • monthly_popularityobject
        • month_1integer
        • month_10integer
        • month_11integer
        • month_12integer
        • month_2integer
        • month_3integer
        • month_4integer
        • month_5integer
        • month_6integer
        • month_7integer
        • month_8integer
        • month_9integer
      • namestring
      • parkobject
        • idinteger
        • namestring
        • urlstring
      • photostring
      • photosinteger
      • popularitynumber
      • private_propertyboolean
      • ratingnumber
      • recordingsinteger
      • reviewsinteger
      • route_typestring
      • slugstring
      • stateobject
        • idinteger
        • namestring
      • text_reviewsinteger
      • urlstring
      • visitor_usageinteger
    • limitinteger
    • next_pageinteger
    • pageinteger
    • totalinteger
  • trails_countinteger
  • type_labelstring
  • urlstring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use AllTrails park or place with its trails API with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.