A scraper for https://bandcamp.com
The scraper allows you to:
- search
artist,album,track,fan,label - get album urls from an artist url
- get album info from an album url
- get album products from an album url
- get artist info from an artist url
Because Bandcamp has shut down their public API and don't plan to reopen it.
https://bandcamp.com/developer
npm i --save bandcamp-scraperSearch any resources that match the given params.query for the current params.page.
- params Object - query String - page Integer (default
1) - callback Function(error, searchResults)
An array of resources that have different properties depending on their type property: artist, album, track, fan, or label.
Every resource matches the search-result JSON schema.
const bandcamp = require('bandcamp-scraper')
const params = {
query: 'Coeur de pirate',
page: 1
}
bandcamp.search(params, function (error, searchResults) {
if (error) {
console.log(error)
} else {
console.log(searchResults)
}
})Search for albums with the tag params.tag for the current params.page.
- params Object - tag String - page Integer (default
1) - callback Function(error, tagResults)
An array of album information. Matches the tag-result JSON schema.
const bandcamp = require('bandcamp-scraper')
const params = {
tag: 'nuwrld',
page: 1
}
bandcamp.getAlbumsWithTag(params, function (error, tagResults) {
if (error) {
console.log(error)
} else {
console.log(tagResults)
}
})Retrieve the album URLs from an artist URL.
Please note: for Bandcamp labels you may want to use the getArtistsUrls function to retrieve the list of signed artists first.
- artistUrl String
- callback Function(error, albumUrls)
const bandcamp = require('bandcamp-scraper')
const artistUrl = 'http://musique.coeurdepirate.com/'
bandcamp.getAlbumUrls(artistUrl, function (error, albumUrls) {
if (error) {
console.log(error)
} else {
console.log(albumUrls)
}
})Retrieves all the album's products from its URL.
- albumUrl String
- callback Function(error, albumProducts)
An array of album products that matches the album-product JSON schema.
const bandcamp = require('bandcamp-scraper')
const albumUrl = 'http://musique.coeurdepirate.com/album/blonde'
bandcamp.getAlbumProducts(albumUrl, function (error, albumProducts) {
if (error) {
console.log(error)
} else {
console.log(albumProducts)
}
})Retrieves the album's info from its URL.
- albumUrl String
- callback Function(error, albumInfo)
An Object that represents the album's info. It matches the album-info JSON schema.
const bandcamp = require('bandcamp-scraper')
const albumUrl = 'http://musique.coeurdepirate.com/album/blonde'
bandcamp.getAlbumInfo(albumUrl, function (error, albumInfo) {
if (error) {
console.log(error)
} else {
console.log(albumInfo)
}
})Retrieves an array of artist URLs from a label's URL for further scraping.
- labelUrl String
- callback Function(error, albumInfo)
const bandcamp = require('bandcamp-scraper')
const labelUrl = 'https://randsrecords.bandcamp.com'
bandcamp.getArtistUrls(labelUrl, function (error, artistsUrls) {
if (error) {
console.log(error)
} else {
console.log(artistsUrls)
}
})Retrieves the artist's info from its URL.
- artistUrl String
- callback Function(error, artistInfo)
An Object that represents the artist's info. It matches the artist-info JSON schema.
const bandcamp = require('bandcamp-scraper')
const artistUrl = 'http://musique.coeurdepirate.com'
bandcamp.getArtistInfo(artistUrl, function (error, artistInfo) {
if (error) {
console.log(error)
} else {
console.log(artistInfo)
}
})Retrieves the track info from its URL.
- trackUrl String
- callback Function(error, trackInfo)
An Object that represents the track's info. It matches the track-info JSON schema.
const bandcamp = require('bandcamp-scraper')
const trackUrl = 'https://dafnez.bandcamp.com/track/serenade'
bandcamp.getTrackInfo(trackUrl, function (error, trackInfo) {
if (error) {
console.log(error)
} else {
console.log(trackInfo)
}
})Feature tests are run daily, thanks to GitHub Action schedule actions. This way we know if the scraper is ever broken.
Run the test:
npm testContribution is welcome! Open an issue first.
MIT.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
