Skip to content
DPLA search widget and suggestion widget.
JavaScript CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


DPLA Discovery

DPLA Discovery is a javascript interface to allow for local website presentation of Digital Public Library of America content.

In the current 0.0.1 release, all that is given is a bare-bones search box with only a
handful of options. Future versions are expected to include more advance searching/filtering
and allow for a type of recommendation system without the need for the search box.

Example Site (temporary)


Step 1 – Request a DPLA API Key

Please follow the instructions to request a DPLA API key, which you’ll need for step 3.

Step 2A – Local:

1. Clone this repository.

2. Place the JS and CSS files somewhere on your server to link to.

3. Add the following to your file updating the script references:

 <link href="suggest.css" rel="stylesheet" type="text/css">
 <link href="pretty.css" rel="stylesheet" type="text/css">
 <script src=""></script>
 <script src="suggest.js"></script>
 <script src="pretty.js"></script>

Step 2B – Linked (evaluation purposes only!):

Add the following to a file:

 <link href="" rel="stylesheet" type="text/css">
 <link href="" rel="stylesheet" type="text/css">
 <script src=""></script>
 <script src=""></script>
 <script src=""></script>

Step 3:

Add the following snippet of code referring to your search box. Insert the API key you received in Step 1 between quotes in place of your DPLA key.

    $(function() {
        api_key: "your DPLA key"
      .bind("fb-select", function(e, data) {, '_blank');
         //To use same window, do, '_self');

Step 4 (Accessibility Fallback Support)

Setup your page something like the following:

 <form method="get" action="">
   <input type="text" name="q" id="mySearchBox" />
   <noscript><input type="submit" name="submit" /></noscript>

Options and Examples

For options (such as page size adjustment or limiting to your institution)
and further examples, please see the index.html file along with files under the “test” directory.


Adding soon.

Known Alpha Bugs

  • Basic “Show More” functionality implemented. Still a tad buggy but works in the most basic case.


More coming soon! For now, feel free to fork and submit improvements. In addition, feel
free to contact me with what might make this usable for your institute at


Contributors are located in the file

Based on:

Source code for base app from Freebase

You can’t perform that action at this time.