Bandcamp-api is API wrapper written in JAVA to retrieve Bandcamp band, album, and track metadata. It utilizes an underlying existing JSON API framework which pre-exists within bandcamp which is also how the website retrieves its data. This project also provides an easy way to execute asynchronous requests against the API.
Just add the following dependencies to your maven pom.xml
<dependency>
<groupId>io.laniakia</groupId>
<artifactId>bandcamp-api</artifactId>
<version>1.0.0</version>
</dependency>Search Endpoint
Config details on the current bandcamp search REST endpoint are stored in /resources/config.xml
Initialize BandcampAPI With Default Threadcount
import io.laniakia.core.BandcampAPI;
...
BandcampAPI bandCampObj = new BandcampAPI();Initialize BandcampAPI With Custom Thread Count
import io.laniakia.core.BandcampAPI;
...
int threadPoolCount = 4;
BandcampAPI bandCampObj = new BandcampAPI(threadPoolCount);Band Search Options
import io.laniakia.core.BandcampAPI;
...
int threadPoolCount = 4;
boolean useThreads = true;
boolean searchMultiplePages = true
BandcampAPI bandCampObj = new BandcampAPI(threadPoolCount);
bandCampObj.searchBand("parallels", searchMultiplePages, useThreads);Search Bands With Asynchronous Requests
import io.laniakia.core.BandcampAPI;
...
BandcampAPI bandCampObj = new BandcampAPI();
bandCampObj.searchBand("parallels", true, true);Search Only First Page Of Results
import io.laniakia.core.BandcampAPI;
...
BandcampAPI bandCampObj = new BandcampAPI();
bandCampObj.searchBand("parallels", false, true);Other API Calls
import io.laniakia.core.BandcampAPI;
...
BandcampAPI bandCampObj = new BandcampAPI();
bandCampObj.searchBand("parallels", false, true);
//Query specific band
bandCampObj.getBand("https://parallels.bandcamp.com/");
//Query album by URL
bandCampObj.getAlbum("https://parallels.bandcamp.com/album/visionaries");
//Query by band and album
bandCampObj.getAlbum("Parallels", "Visionaries");Clone from remote repository then mvn install. All of the modules will be installed to your local maven repository.
git clone https://github.com/scriptkittie/bandcamp-api.git
cd bandcamp-api
mvn installPlease report any issues to the issues section & as always if you have any functionality requests go ahead and open an issue containing your suggestions.
If you have an addition to the project, fork it and submit a pull request. Any type of contributions are welcome.
Package written by StCypher
API calls made to Bandcamp