Skip to content

Project to access and make meaningful use of the Smithsonian Open Access API

Notifications You must be signed in to change notification settings

datajango/smithsonian

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ACTIVATING SMITHSONIAN OPEN ACCESS

Why was this repo was created?

This repo was created to build new interactive, collaborative applications that use the Smithsonian Institution Open Access API.

Smithsonian Institution Open Access API

On February 25, 2020, the Smithsonian launched Open Access, releasing 2.8 million 2D and 3D images and 173-years of staff-created data into the public domain as Creative Commons Zero. Open Access furthers the Smithsonian’s mission which has been the same since its founding in 1846: for the "increase and diffusion of knowledge."

The Open Access API was released as part of the launch allowing you to connect to the 2.8 million "open access” collections and corresponding metadata. This is a CC0 subset of the Smithsonian’s 155 million objects, 2.1 million library volumes and 156,000 cubic feet of archival collections held in 19 museums, 9 research centers, libraries, archives and the National Zoo. Digitization of collections is ongoing.

Sub Projects

Update 2/23/2021

The Open Access Search tool and the Open Access API share Accession Number which can be used to load image assets. Suppose you want to find "masks", go to Smithsonian Open Access and enter "mask".

search-mask

The detail page has an Accession Number on the right hand side.

mask

I used the Accession Number 1952-76-2 in the API POC I wrote.

To test this:

conda activate smith
cd smith-api-poc
cd src
python get_content.py

Which returns the following JSON snippet:

"media": [
    {
        "thumbnail": "https://ids.si.edu/ids/deliveryService?id=CHSDM-9BFC7BDCAAE92-000001",
        "idsId": "CHSDM-9BFC7BDCAAE92-000001",
        "usage": {
            "access": "CC0"
        },
        "guid": "http://n2t.net/ark:/65665/vc9f8023858-3a20-49f7-b89f-717438b5a60a",
        "type": "Images",
        "content": "https://ids.si.edu/ids/deliveryService?id=CHSDM-9BFC7BDCAAE92-000001",

The image URL matches the "content" URL.

mask-url

Branches

Owning Units

Owning Units are internal Smithsonian acronyms. Below are a list of codes to descriptions.

  1. AAA -- Archives of American Art
  2. ACM -- Anacostia Community Museum
  3. CFCHFOLKLIFE -- Ralph Rinzler Folklife Archives and Collections
  4. CHNDM -- Cooper Hewitt, Smithsonian Design Museum
  5. EEPA -- Eliot Elisofon Photographic Archives
  6. FBR -- Smithsonian Field Book Project
  7. FSG -- Freer Gallery of Art and Arthur M. Sackler Gallery
  8. HAC -- Smithsonian Gardens
  9. HMSG -- Hirshhorn Museum and Sculpture Garden
  10. HSFA -- Human Studies Film Archives
  11. NAA -- National Anthropological Archives
  12. NASM -- National Air and Space Museum
  13. NMAAHC -- National Museum of African American History and Culture
  14. NMAH -- National Museum of American History
  15. NMAI -- National Museum of the American Indian
  16. NMAfA -- National Museum of African Art
  17. NMNH --- National Museum of Natural History
  18. NMNHANTHRO -- NMNH - Anthropology Dept.
  19. NMNHBIRDS -- NMNH - Vertebrate Zoology - Birds Division
  20. NMNHBOTANY -- NMNH - Botany Dept.
  21. NMNHEDUCATION -- NMNH - Education & Outreach
  22. NMNHENTO -- NMNH - Entomology Dept.
  23. NMNHFISHES -- NMNH - Vertebrate Zoology - Fishes Division
  24. NMNHHERPS -- NMNH - Vertebrate Zoology - Herpetology Division
  25. NMNHINV -- NMNH - Invertebrate Zoology Dept.
  26. NMNHMAMMALS -- NMNH - Vertebrate Zoology - Mammals Division
  27. NMNHMINSCI -- NMNH - Mineral Sciences Dept.
  28. NMNHPALEO -- NMNH - Paleobiology Dept.
  29. NPG -- National Portrait Gallery
  30. NPM -- National Postal Museum
  31. NZP -- Smithsonian's National Zoo & Conservation Biology Institute
  32. SAAM -- Smithsonian American Art Museum
  33. SIA -- Smithsonian Institution Archives
  34. SIL -- Smithsonian Libraries

Metadata Repo

The repo Smithsonian Open Access Metadata Repository (GitHub) contains over 11 million metadata records from the Smithsonian Institution serialized as line-delimited JSON and compressed into bzip2 format.

My theories on this repo:

  1. Downloading this repo is similair in concept to executing 11 million REST API calls or some huge number of REST Api calls.
  2. One could build a database from the 11 million metadata records and use the this database as a fast index cache to search the Smithsonian's assets quickly.

Resources and Links

API + GitHub

JavaScript Libraries

About

Project to access and make meaningful use of the Smithsonian Open Access API

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages