{"id":26397609,"url":"https://github.com/datajango/smithsonian","last_synced_at":"2025-03-17T12:18:21.055Z","repository":{"id":54393763,"uuid":"340700805","full_name":"datajango/smithsonian","owner":"datajango","description":"Project to access and make meaningful use of the Smithsonian Open Access API","archived":false,"fork":false,"pushed_at":"2021-02-24T04:00:16.000Z","size":9350,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2023-03-07T08:22:23.835Z","etag":null,"topics":["api","python","smithsonian"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datajango.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-02-20T16:34:09.000Z","updated_at":"2022-08-08T17:56:37.000Z","dependencies_parsed_at":"2022-08-13T14:20:31.933Z","dependency_job_id":null,"html_url":"https://github.com/datajango/smithsonian","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datajango%2Fsmithsonian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datajango%2Fsmithsonian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datajango%2Fsmithsonian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datajango%2Fsmithsonian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datajango","download_url":"https://codeload.github.com/datajango/smithsonian/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244031121,"owners_count":20386534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","python","smithsonian"],"created_at":"2025-03-17T12:18:20.505Z","updated_at":"2025-03-17T12:18:21.038Z","avatar_url":"https://github.com/datajango.png","language":"Python","readme":"# ACTIVATING SMITHSONIAN OPEN ACCESS\n\n## Why was this repo was created?\n\nThis repo was created to build new interactive, collaborative applications that use the Smithsonian Institution Open Access API.\n\n### Smithsonian Institution Open Access API\n\nOn 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.\"\n\nThe 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.\n\n\n## Sub Projects\n\n- [Smithsonian Open Access API Proof of Concept](./smith-api-poc/README.md)\n\n\u003cb\u003eUpdate 2/23/2021\u003c/b\u003e\n\nThe 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](https://www.si.edu/openaccess) and enter \"mask\".\n\n![search-mask](./search-mask.png)\n\nThe detail page has an Accession Number on the right hand side.\n\n![mask](./mask.png)\n\nI used the  Accession Number 1952-76-2 in the API POC I wrote.\n\nTo test this:\n\n```\nconda activate smith\ncd smith-api-poc\ncd src\npython get_content.py\n```\nWhich returns the following JSON snippet:\n\n```JSON\n\"media\": [\n    {\n        \"thumbnail\": \"https://ids.si.edu/ids/deliveryService?id=CHSDM-9BFC7BDCAAE92-000001\",\n        \"idsId\": \"CHSDM-9BFC7BDCAAE92-000001\",\n        \"usage\": {\n            \"access\": \"CC0\"\n        },\n        \"guid\": \"http://n2t.net/ark:/65665/vc9f8023858-3a20-49f7-b89f-717438b5a60a\",\n        \"type\": \"Images\",\n        \"content\": \"https://ids.si.edu/ids/deliveryService?id=CHSDM-9BFC7BDCAAE92-000001\",\n```\n\nThe image URL matches the \"content\" URL.\n\n![mask-url](./mask-url.png)\n\n## Branches\n\n- [Develop Branch](./DEVELOP.md)\n\n## Owning Units\n\nOwning Units are internal Smithsonian acronyms. Below are a list of codes to descriptions.\n\n1. AAA -- Archives of American Art\n1. ACM -- Anacostia Community Museum\n1. CFCHFOLKLIFE -- Ralph Rinzler Folklife Archives and Collections\n1. CHNDM -- Cooper Hewitt, Smithsonian Design Museum\n1. EEPA -- Eliot Elisofon Photographic Archives\n1. FBR -- Smithsonian Field Book Project\n1. FSG -- Freer Gallery of Art and Arthur M. Sackler Gallery\n1. HAC -- Smithsonian Gardens\n1. HMSG -- Hirshhorn Museum and Sculpture Garden\n1. HSFA -- Human Studies Film Archives\n1. NAA -- National Anthropological Archives\n1. NASM -- National Air and Space Museum\n1. NMAAHC -- National Museum of African American History and Culture\n1. NMAH -- National Museum of American History\n1. NMAI -- National Museum of the American Indian\n1. NMAfA -- National Museum of African Art\n1. NMNH --- National Museum of Natural History\n1. NMNHANTHRO -- NMNH - Anthropology Dept.\n1. NMNHBIRDS -- NMNH - Vertebrate Zoology - Birds Division\n1. NMNHBOTANY -- NMNH - Botany Dept.\n1. NMNHEDUCATION -- NMNH - Education \u0026 Outreach\n1. NMNHENTO -- NMNH - Entomology Dept.\n1. NMNHFISHES -- NMNH - Vertebrate Zoology - Fishes Division\n1. NMNHHERPS -- NMNH - Vertebrate Zoology - Herpetology Division\n1. NMNHINV -- NMNH - Invertebrate Zoology Dept.\n1. NMNHMAMMALS -- NMNH - Vertebrate Zoology - Mammals Division\n1. NMNHMINSCI -- NMNH - Mineral Sciences Dept.\n1. NMNHPALEO -- NMNH - Paleobiology Dept.\n1. NPG -- National Portrait Gallery\n1. NPM -- National Postal Museum\n1. NZP -- Smithsonian's National Zoo \u0026 Conservation Biology Institute\n1. SAAM -- Smithsonian American Art Museum\n1. SIA -- Smithsonian Institution Archives\n1. SIL -- Smithsonian Libraries\n\n## Metadata Repo\n\nThe repo [Smithsonian Open Access Metadata Repository (GitHub)](https://github.com/Smithsonian/OpenAccess) contains over 11 million metadata records from the Smithsonian Institution serialized as line-delimited JSON and compressed into bzip2 format.\n\nMy theories on this repo:\n\n1. Downloading this repo is similair in concept to executing 11 million REST API calls or some huge number of REST Api calls.\n1. 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.\n\n\n## Resources and Links\n\n- [8 Great Interactive\nArt Experiences\nto Get Us Through\nthe Winter Doldrums](https://www.creativefuture.org/8-great-interactive-art-experiences/)\n- [Virtual Smithsonian](https://www.si.edu/dashboard/virtual-smithsonian)\n- [Open Access Developer Tools](https://www.si.edu/openaccess/devtools)\n- [COOPER HEWITT INTERACTION LAB PRESENTS: ACTIVATING SMITHSONIAN OPEN ACCESS](https://www.cooperhewitt.org/activating-smithsonian-open-access/)\n- [ACTIVATING SMITHSONIAN OPEN ACCESS: INFORMATION SESSION](https://www.eventbrite.com/e/activating-smithsonian-open-access-information-session-tickets-138341106975)\n\n## API + GitHub\n\n- [Open Access Developer Tools](https://www.si.edu/openaccess/devtools)\n- [OpenAccess](https://github.com/Smithsonian/OpenAccess)\n- [Smithsonian Institution Open Access API - API documentation](http://edan.si.edu/openaccess/apidocs/)\n- [Smithsonian Institution Enterprise Data Access Network + Open Access Initiative Content Repository](http://edan.si.edu/openaccess/docs/)\n\n\n## JavaScript Libraries\n\n- [P5 JS](https://p5js.org/)\n- [Fabric JS](http://fabricjs.com/)\n- [Paper JS](http://paperjs.org/)\n- [Phaser](https://phaser.io/)\n- [Pixi JS](https://www.pixijs.com/)\n- [Three JS](https://threejs.org/)\n- [Easel JS](https://www.createjs.com/easeljs)\n- [D3 JS](https://d3js.org/)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatajango%2Fsmithsonian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatajango%2Fsmithsonian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatajango%2Fsmithsonian/lists"}