Smithsonian Collections Search (Museum Objects, Specimens and Archives Metadata)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "What to search for: plain words (apollo 11), AND / OR, or fielded terms such as unit_code:NMAH (National Museum of American History), topic:Gastropoda. unit_code values are the Smithsonian's unit acronyms (NMAH, NMNHBOTANY, NASM, SAAM, NPG, CHNDM, NMAI, SIL ...). A malformed expression is not an error: it returns zero matches."
    },
    "rows": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "How many records to return in this page, 1 to 50. Default 10."
    },
    "start": {
      "type": "integer",
      "default": 0,
      "maximum": 1000000,
      "minimum": 0,
      "description": "Zero-based offset of the first record to return, for paging: 0, then rows, then 2*rows. Reaches 1,000,000; a query with more matches than that should be narrowed instead."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "rowCount",
    "rows"
  ],
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "url",
          "title",
          "unitCode",
          "content"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The Smithsonian's row id for the record."
          },
          "url": {
            "type": "string",
            "description": "The record's identifier, for example edanmdm:nmah_1464762. The part after edanmdm: is the record_id Smithsonian Collections Object takes."
          },
          "type": {
            "type": "string",
            "description": "The record type, edanmdm for an object."
          },
          "title": {
            "type": "string",
            "description": "The object's title or name."
          },
          "content": {
            "type": "object",
            "required": [
              "descriptiveNonRepeating",
              "freetext",
              "indexedStructured"
            ],
            "properties": {
              "freetext": {
                "type": "object",
                "description": "The record's text fields (date, name, place, notes, physicalDescription, identifier, objectType, creditLine, topic ...), each a list of {label, content}.",
                "additionalProperties": true
              },
              "indexedStructured": {
                "type": "object",
                "description": "The search facets: object_type, date (decade or century buckets), place, name, topic, geoLocation, online_media_type.",
                "additionalProperties": true
              },
              "descriptiveNonRepeating": {
                "type": "object",
                "required": [
                  "metadata_usage"
                ],
                "properties": {
                  "metadata_usage": {
                    "type": "object",
                    "required": [
                      "access"
                    ],
                    "properties": {
                      "access": {
                        "enum": [
                          "CC0"
                        ],
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "description": "record_ID (the museum's own id, for example nmah_1464762), data_source (the owning unit's name), guid (a persistent link to the record), record_link (the museum's own page, when it has one) and metadata_usage.access, always CC0.",
                "additionalProperties": true
              }
            },
            "description": "The metadata: descriptiveNonRepeating (record_ID, data_source, guid, record_link, metadata_usage), freetext (fields as lists of {label, content}, in the museum's wording) and indexedStructured (the search facets: object_type, date buckets, place, name, topic, coordinates).",
            "additionalProperties": false
          },
          "unitCode": {
            "type": "string",
            "description": "The owning unit's acronym, for example NMAH or NMNHBOTANY."
          },
          "timestamp": {
            "type": "string",
            "description": "When the index first took the record in, Unix seconds as a string."
          },
          "lastTimeUpdated": {
            "type": "string",
            "description": "When the index last re-read the record, Unix seconds as a string. Not the date the object was made."
          }
        },
        "additionalProperties": false
      },
      "description": "The requested page, in the Smithsonian's relevance order."
    },
    "rowCount": {
      "type": "integer",
      "description": "The total number of records matching q, not the number returned. 0 for no match and for a malformed expression."
    },
    "notCc0Omitted": {
      "type": "integer",
      "description": "Present only when records the Smithsonian did not mark CC0 were dropped from this page; it counts them."
    }
  },
  "description": "The page of matching records and the total match count. Records are CC0 metadata only.",
  "additionalProperties": false
}