Department of Interior Multimedia/galleries API

openapi: 3.2.0
info:
  description: This API is designed to provide authoritative National Park Service (NPS) data and content about parks and their facilities, events, news, alerts, and more. Explore the NPS API below and even try to make API calls. In order to try an API call, you'll need to click on the "Authorize" button below and add your API key. If you don't have an API key yet, visit our Get Started page.
  version: 1.0.0
  title: National Park Service Multimedia/galleries API
servers:
- url: https://developer.nps.gov/api/v1
tags:
- name: multimedia/galleries
  description: Retrieve galleries created by national parks and other NPS entities.
paths:
  /multimedia/galleries:
    get:
      tags:
      - multimedia/galleries
      description: Returns multimedia galleries from National Park Service sites, with optional filters for park codes, state codes, or a search term.
      operationId: getMultimediaGalleries
      parameters:
      - name: parkCode
        in: query
        description: A comma delimited list of 4 character park codes.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: stateCode
        in: query
        description: A comma delimited list of 2 character state codes.
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: limit
        in: query
        description: Number of results to return per request. Default is 50.
        required: false
        schema:
          type: integer
      - name: start
        in: query
        description: Get the next [limit] results starting with this number. Default is 0.
        required: false
        schema:
          type: integer
      - name: q
        in: query
        description: Term to search on
        required: false
        schema:
          type: string
      security:
      - api_key: []
      - api_key_header: []
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MultimediaGalleries'
        '400':
          description: Invalid status value
      summary: Get multimedia galleries
      x-summary-source: derived
components:
  schemas:
    MultimediaGalleries:
      type: object
      properties:
        total:
          type: string
          example: '29'
        limit:
          type: string
          example: '50'
        start:
          type: string
          example: '0'
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                example: F2D0A8A2-155D-451F-67A9-A67E74025286
              url:
                type: string
                example: https://www.nps.gov/media/photo/gallery.htm?id=F2D0A8A2-155D-451F-67A9-A67E74025286
              title:
                type: string
                example: 2008 Postcard Contest Winners
              description:
                type: string
                example: ''
              images:
                type: array
                items:
                  type: object
                  properties:
                    url:
                      type: string
                      example: https://www.nps.gov/npgallery/GetAsset/F2D0A915-155D-451F-67EA-767489860884
                    altText:
                      type: string
                      example: '1st place: 6th – 8th grade category'
                    title:
                      type: string
                      example: '1st place: 6th – 8th grade category'
                    description:
                      type: string
                      example: '1st place: 6th – 8th grade category'
              relatedParks:
                type: array
                items:
                  type: object
                  properties:
                    states:
                      type: string
                      example: MT
                    parkCode:
                      type: string
                      example: glac
                    designation:
                      type: string
                      example: National Park
                    fullName:
                      type: string
                      example: Glacier National Park
                    url:
                      type: string
                      example: https://www.nps.gov/glac/index.htm
                    name:
                      type: string
                      example: Glacier
              tags:
                type: array
                items:
                  type: string
                  example: bark ranger
              assetCount:
                type: integer
                example: 13
              constraintsInfo:
                type: object
                properties:
                  constraint:
                    type: string
                    example: Public domain
                  grantingRights:
                    type: string
                    example: unknown
              copyright:
                type: string
                example: 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.
  securitySchemes:
    api_key:
      type: apiKey
      name: api_key
      in: query
    api_key_header:
      type: apiKey
      name: X-Api-Key
      in: header
x-provenance:
  method: harvested
  publisher: Department of Interior
  source: https://www.nps.gov/subjects/developer/customcf/swagger.json?03142019
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)