internet-archive

An npm module for the Internet Archive API.

Usage

Main Endpoints

Only two endpoints are present:

• advancedSearch
• metadata

Begin by including the module:

var ia = require('internet-archive');
 

Advanced Search

Create an options/parameters object, and specify the query, number of results to show, and the filter on what information to return for each result.

The below example's query searches for movies that match 'Disneyland' and are part of either the home_movies or prelingerhomemovies collection. The example returns up to 15 results, and specifies that only the identifier, title, collection, number of downloads/views, description and date fields are returned for each result.

Please see the Internet Archive's API Example queries page for further information on precise queries and using boolean operators.

var params = {
 q: 'Disneyland AND mediatype:movies AND collection:(home_movies OR prelingerhomemovies)',
 rows: '15',
 fl: ['identifier,title,collection,downloads,description,date']
};
 
ia.advancedSearch(params, function(err, results) {
    if (err) console.error(err);
    console.log(JSON.stringify(results.response, null, 2));
});
 

Metadata

To return a specific item's details, you'll need the item's identifier from advancedSearch.

ia.metadata('FrankenberryCountChoculaTevevisionCommercial1971', function(err, results){
    if (err) console.error(err);
    console.log(JSON.stringify(results, null, 2));
});