multimedia/audio

GET /multimedia/audio

Returns audio resources from National Park Service sites, with optional filters for park codes, state codes, or a search term.

Request

  • Base URL
    https://developer.nps.gov/api/v1
  • Auth
    • API key in query parameter api_key
    • or API key in header X-Api-Key

Query parameters

parkCodestring[]

A comma delimited list of park codes (each 4 characters in length).

stateCodestring[]

A comma delimited list of 2 character state codes.

limitinteger

Number of results to return per request. Default is 50.

startinteger

Get the next [limit] results starting with this number. Default is 0.

qstring

Term to search on

Response

successful operation

totalstring
limitstring
startstring

Example response

{
  "total": "3427",
  "data": [
    {
      "id": "6A437071-C23A-4754-ABBD-47027A1464E0",
      "permalinkUrl": "https://www.nps.gov/media/video/view.htm?id=6A437071-C23A-4754-ABBD-47027A1464E0",
      "title": "Theodore Roosevelt A Complicated Legacy",
      "description": "No one is infallible, not our heroes, not our leaders, not even those who pioneered for the preservation of the natural world. President Theodore Roosevelt left a complex legacy. While he helped to create the National Park Service and set out to protect and preserve public lands, he excluded Indigenous voices. What would it be like to sit down and talk with Teddy today? —What would you ask him? In this episode, park visitors share how they respond to this multifaceted human and the legacy he left behind.",
      "splashImage": {
        "url": "https://www.nps.gov/common/uploads/ser/park/carl//896018B2-B099-D284-F1497C6FEA15018B/896018B2-B099-D284-F1497C6FEA15018B-large.jpg"
      },
      "relatedParks": [
        {
          "states": "AZ",
          "parkCode": "grca",
          "designation": "National Park",
          "fullName": "Grand Canyon National Park",
          "url": "https://www.nps.gov/grca/index.htm",
          "name": "Grand Canyon"
        }
      ],
      "tags": [
        "Theodore Roosevelt",
        "Grand Canyon",
        "Presidency",
        "CONSERVATION LEGACY",
        "NATIVE AMERICAN CULTURE",
        "legacy and national park service",
        "diversity",
        "Native American",
        "American Indian"
      ],
      "latitude": 36.0566279811578,
      "longitude": -112.143759727478,
      "durationMs": 1263020,
      "credit": "Behind the Scenery Podcast",
      "versions": [
        {
          "fileSize": 50539839,
          "fileType": "audio/mp3",
          "url": "https://www.nps.gov/nps-audiovideo/audiovideo/754f468d-0777-4647-b64b-d59c2c7803bd.mp3"
        }
      ]
    }
  ],
  "limit": "50",
  "start": "0"
}

Changes

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