#HackFSM

In addition to the API provided by the Library, you are welcome to use other APIs and content sources. 

The Pop Up Archive API (https://developer.popuparchive.com) makes it possible to search across audio collections, individual items, transcripts, and a variety of other metadata. Specifically, collections 1712 (UCSF Archives & Special Collections) and 1703 (UC-Berkeley Ethnic Studies Library) contain Free Speech Movement audio.
 
For general search, use the Search method. To limit your search to a particular collection, use the filters[collection_id] filter. For example, if we use the following parameters:
query: Rahm Emanuel 
page: 1
filters[collection_id]: [This field is optional, but you can use it to narrow your search to a specific collection.]
 
To view the contents of an entire collection, use the Search method with filters[collection_id] to return one collection of audio with all facets at the top of the response: 
 
query: [can be blank, or any search term/facet in the docs] 
page: 1
filters[collection_id]: 1703
 
The search output json includes:
  1. Facets- each facet is a means of refining data. So for the Rahm Emanuel search, you can see that out of 12 interviews, two include information on who conducted the interviews for this data set (Vincent Fay and Charlie Meyerson). 

2. Results- These are individual items. The search JSON includes the item id and the collection id, as well as the ids for the audio files associated to the item. You can use the audio file id to retrieve an audio file, or get the audio file URL directly from the item's attributes. These results also include timestamped bits of the transcript that contain the search term as well as auto-generated tags  (entitiesand a subset of manually generated metadata (or metadata we have imported from a feed). 

 

#HackFSM was a one-time event held in April 2014. The winning site is now available. A white paper on #HackFSM has also been published, with practical information for other libraries that are interested in holding hackathons.