NPnps
multimedia/galleries/assets

GET /multimedia/galleries/assets

Returns assets in National Park Service multimedia galleries, with optional filters for asset ID, gallery ID, park code, state code, 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

idstring

The unique identifier of an asset within a gallery

galleryIdstring

The unique identifier for a gallery

parkCodestring[]

A comma delimited list of 4 character park codes.

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": "13",
  "limit": "50",
  "start": "0",
  "data": [
    {
      "id": "F2D0A915-155D-451F-67EA-767489860884",
      "permalinkUrl": "https://www.nps.gov/media/photo/gallery-item.htm?pg=1&id=F2D0A915-155D-451F-67EA-767489860884&gid=F2D0A8A2-155D-451F-67A9-A67E74025286",
      "title": "1st place: 6th – 8th grade category",
      "description": "1st place: 6th – 8th grade category",
      "altText": "1st place: 6th – 8th grade category",
      "fileInfo": {
        "url": "https://www.nps.gov/npgallery/GetAsset/F2D0A915-155D-451F-67EA-767489860884",
        "fileType": "image/jpeg",
        "widthPixels": 1024,
        "heightPixels": 768,
        "fileSizeKb": 147265
      },
      "relatedParks": [
        {
          "states": "MT",
          "parkCode": "glac",
          "designation": "National Park",
          "fullName": "Glacier National Park",
          "url": "https://www.nps.gov/glac/index.htm",
          "name": "Glacier"
        }
      ],
      "tags": [
        "postcard"
      ],
      "constraintsInfo": {
        "constraint": "Public domain",
        "grantingRights": "Full"
      },
      "copyright": "Permission must be secured from the individual copyright owners to reproduce any copyrighted materials contained within this website. Digital assets without any copyright restrictions are public domain.",
      "ordinal": 1
    }
  ]
}

Changes

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