> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/getting-started/national-parks.md).

# US national parks in Duaer

In Duaer: National Park Service: parks, monuments, and historic sites with location, fees, and activities. One successful search uses 1 credit.
## What you get

Duaer US national parks searches National Park Service sites by words or state, with location, entrance fee, activities, and an image. Duaer holds the upstream API key; you only send your Duaer key.

Pick Duaer Data → US national parks in the node creator, or open the [data market](/getting-started/data-market.md). Related: [Weather forecast](/getting-started/weather.md), [Places nearby](/getting-started/places-nearby.md).

## When to use it

- Plan a trip to parks in Utah.
- Show the entrance fee and activities of Yosemite.

## When not to use it

- Weather at a park. Use [Weather forecast](/getting-started/weather.md).
- Places nearby on a map. Use [Places nearby](/getting-started/places-nearby.md).

## Search on the canvas

1. Open the node creator and pick Duaer Data → US national parks.
2. Fill at least one of Words (such as canyon), State (such as UT).
3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

## Call the API

- GET https://api.duaer.com/v1/data/national-parks?words=yosemite
- Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

## Call skill

Same text as Copy skill.

```
---
name: duaer-national-parks
description: >-
  Duaer US national parks. National Park Service: parks, monuments, and historic sites with location, fees, and activities.
  One successful search uses 1 Duaer credit.
---

# Duaer US national parks

Duaer US national parks searches National Park Service sites by words or state, with location, entrance fee, activities, and an image. Duaer holds the upstream API key; you only send your Duaer key.

## When to use

- Plan a trip to parks in Utah.
- Show the entrance fee and activities of Yosemite.

## When not to use

- Weather at a park. Use https://skills.duaer.com/weather.md.
- Places nearby on a map. Use https://skills.duaer.com/places-nearby.md.

## Call

`GET https://api.duaer.com/v1/data/national-parks?words=yosemite`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words` or `state`.

- `words` — Optional. Words such as yosemite or canyon.
- `state` — Optional. Two-letter state code such as UT.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/national-parks?words=yosemite` — sites matching Yosemite.
- `GET https://api.duaer.com/v1/data/national-parks?state=UT` — National Park Service sites in Utah.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `parkCode`, `name`, `designation`, `states` — site and type.
- `latitude`, `longitude`, `description` — location and description.
- `entranceFeeUsd`, `entranceFee`, `activities`, `imageUrl`, `imageAlt` — first fee, up to eight activities, and an image.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/weather.md — Duaer Weather forecast
- https://skills.duaer.com/places-nearby.md — Duaer Places nearby

```
## Questions

### How many credits does a US national parks search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

### Does Duaer US national parks list only national parks?

No. It includes monuments, historic sites, seashores, and other National Park Service sites; the designation field names the type.

## Related

- [Weather forecast in Duaer](https://doc.duaer.com/getting-started/weather.md)
- [Places nearby in Duaer](https://doc.duaer.com/getting-started/places-nearby.md)