Bandcamp.com Crawler The Bandcamp.com crawler is a web scraping tool that allows you to extract data from the Bandcamp music platform. With this crawler, you can get information about albums, tracks, and much more. The crawler is built on top of Apify SDK, and you can run it both on the Apify platform and locally. ## Features - Scrape data from search pages, albums and tracks on Bandcamp.com. - Get information about an artist's discography, including album titles, tags, and tracklists. - Collect information about tracks, including the title, length, and position. ## How to use the Bandcamp.com crawler The Bandcamp.com crawler is straightforward to use and doesn't require any coding skills to start using it. Here are the steps to get started: 1. Set up an Apify account if you don't have one already. 2. Create a new task and select the Bandcamp.com crawler. 3. Choose the parameters you want to scrape. 4. Run the task and download the results. ## Input parameters The following table lists the input parameters for this scraper: - startUrls (Array): URLs to fetch data from. - maxPagesToSearch (Integer): When the starting URL is a search page, this parameter will define how many pages to crawl. Default value is 6. - fetchAlbumsFromSearch (Boolean): Will fetch album details found in the search pages and store them as individual items when activated. Default value is false. - fetchTracksFromSearch (Boolean): Will fetch track details found in the search pages and store them as individual items when activated. Default value is false. - fetchAlbumsFromDiscover (Boolean): Will fetch album details found in the search pages and store them as individual items when activated. Default value is false. - fetchArtistsFromDiscover (Boolean): Will fetch album details found in the search pages and store them as individual items when activated. Default value is false. - fetchTracksFromAlbum (Boolean): Will fetch track details found in the album pages and store them as individual items when activated. Default value is false. - fetchAlbumFromTrack (Boolean): Will fetch album details found in the track pages and store them as individual items when activated. Default value is false. - proxy (Object): Proxy configuration. You can edit this to use Apify proxy, or provide your own proxy servers. Default value is { "useApifyProxy": false }. - debug (Boolean): See detailed logs when activated. Default value is false. ### Input examples Here are the supported URL type: - Search page: Ex. https://bandcamp.com/search?q=five+finger+death+punch&page=1 - Music page: Ex. https://fivefingerdeathpunch.bandcamp.com/music - Album page: Ex. https://badwolves.bandcamp.com/album/n-a-t-i-o-n - Track page: Ex. https://inflamesofficial.bandcamp.com/track/in-the-dark - Discover page: Ex. https://bandcamp.com/discover/metal This is an example of how your input will look like if you decide to scrape 2 pages from a search URL and fetching every albums and tracks found: json { "startUrls": [ { "url": "https://bandcamp.com/search?q=five+finger+death+punch&page=1" } ], "maxPagesToSearch": 2, "fetchAlbumsFromSearch": true, "fetchTracksFromSearch": true, "fetchTracksFromAlbum": false, "fetchAlbumFromTrack": false, "proxy": { "useApifyProxy": false }, "debug": false } ### Results example The output from scraping Bandcamp is stored in the dataset. Each search page, album or track is stored as an item inside the dataset. After the run is finished, you can download the scraped data onto your computer or export to any web app in various data formats (JSON, CSV, XML, RSS, HTML Table). Here's a few examples of the outputs you can get for different types of inputs: #### Search result json { "dataType": "search", "pagination": { "page": 1, "pages": 4, "urls": { "first": "https://bandcamp.com/search?q=five+finger+death+punch&page=1", "last": "https://bandcamp.com/search?page=4&q=five%20finger%20death%20punch", "next": "https://bandcamp.com/search?page=2&q=five%20finger%20death%20punch" } }, "results": [ { "dataType": "artist", "title": "Five Finger Death Punch", "url": "https://fivefingerdeathpunch.bandcamp.com?from=search&search_item_id=3335222211&search_item_type=b&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=1&search_sig=c7911448b1e616c16be10b29ef0bafba", "image": { "url": "https://f4.bcbits.com/img/0027318719_23.jpg" } }, { "dataType": "album", "title": "AfterLife", "url": "https://fivefingerdeathpunch.bandcamp.com/album/afterlife?from=search&search_item_id=730568840&search_item_type=a&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=2&search_sig=3a134a4b690ce50ecc09185f5021f7fc", "image": { "url": "https://f4.bcbits.com/img/a3711245885_7.jpg" } }, { "dataType": "album", "title": "F8", "url": "https://fivefingerdeathpunch.bandcamp.com/album/f8?from=search&search_item_id=1517960920&search_item_type=a&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=3&search_sig=9ac9c83b9a512bf9efb0a19ca5cc5e52", "image": { "url": "https://f4.bcbits.com/img/a1228029165_7.jpg" } }, { "dataType": "album", "title": "Five Finger Death Punch - Under And Over It (Psyfonic Remix)", "url": "https://sundepartmentrecords.bandcamp.com/album/five-finger-death-punch-under-and-over-it-psyfonic-remix?from=search&search_item_id=3957120201&search_item_type=a&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=4&search_sig=a5758aeb8bd38946c42dc87d9d76c8cb", "image": { "url": "https://f4.bcbits.com/img/a1812136479_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch - Far From Home (dj genesis remix)", "url": "https://djgenesis.bandcamp.com/track/five-finger-death-punch-far-from-home-dj-genesis-remix?from=search&search_item_id=3079992419&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=5&search_sig=b17fd2515dd478c36daafdfc3d217635", "image": { "url": "https://f4.bcbits.com/img/a1014191913_7.jpg" } }, { "dataType": "track", "title": "The Bleeding (Five Finger Death Punch)", "url": "https://soundblade.bandcamp.com/track/the-bleeding-five-finger-death-punch?from=search&search_item_id=2917400532&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=6&search_sig=2bf31006cbbb413563a224286dabcf55", "image": { "url": "https://f4.bcbits.com/img/a0104106560_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch - Under And Over It (Psyfonic Remix)", "url": "https://sundepartmentrecords.bandcamp.com/track/five-finger-death-punch-under-and-over-it-psyfonic-remix?from=search&search_item_id=733570244&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=7&search_sig=412e4982a8496f692e58b38c7fc30292", "image": { "url": "https://f4.bcbits.com/img/a1812136479_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch", "url": "https://losgoldfires.bandcamp.com/track/five-finger-death-punch?from=search&search_item_id=1680490536&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=8&search_sig=70e39ae180daf42b172b65c0684e71b3", "image": { "url": "https://f4.bcbits.com/img/a0560304956_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch - House of the rising sun", "url": "https://juancardoni.bandcamp.com/track/five-finger-death-punch-house-of-the-rising-sun?from=search&search_item_id=650406241&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=9&search_sig=efb9b95986b1992c7f355ed8aee556cd", "image": { "url": "https://f4.bcbits.com/img/a3085939771_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch - The Bleeding (Vocal Cover)", "url": "https://alonsoramirez.bandcamp.com/track/five-finger-death-punch-the-bleeding-vocal-cover?from=search&search_item_id=2478235599&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=10&search_sig=a77ad3f7eca7ffca2a3fe5d9e79690ff", "image": { "url": "https://f4.bcbits.com/img/a1362250685_7.jpg" } }, { "dataType": "track", "title": "IOU", "url": "https://fivefingerdeathpunch.bandcamp.com/track/iou?from=search&search_item_id=198017150&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=11&search_sig=ecea75ea45db7cdeb12687f4d2bab5f4", "image": { "url": "https://f4.bcbits.com/img/a3711245885_7.jpg" } }, { "dataType": "track", "title": "Gone Away {Five Finger Death Punch} Cover", "url": "https://kevinaskew1.bandcamp.com/track/gone-away-five-finger-death-punch-cover?from=search&search_item_id=42115164&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=12&search_sig=12d52c01b56ac57bf913bfa38e8fead8", "image": { "url": "https://f4.bcbits.com/img/a0919171835_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch \"Under And Over It\" [KRADDY Remix]", "url": "https://kraddy.bandcamp.com/track/five-finger-death-punch-under-and-over-it-kraddy-remix?from=search&search_item_id=1090837093&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=13&search_sig=77e291f670e2dc079d15f3ce150d1fd3", "image": { "url": "https://f4.bcbits.com/img/a4153950494_7.jpg" } }, { "dataType": "track", "title": "Gone Away {Five Finger Death Punch Vocal Cover}", "url": "https://kevinaskew1.bandcamp.com/track/gone-away-five-finger-death-punch-vocal-cover?from=search&search_item_id=3696082903&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=14&search_sig=666fd185109692abced37106756119bf", "image": { "url": "https://f4.bcbits.com/img/a2171177923_7.jpg" } }, { "dataType": "track", "title": "Inside Out", "url": "https://fivefingerdeathpunch.bandcamp.com/track/inside-out-1?from=search&search_item_id=3043631498&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=15&search_sig=06b3406626b89402385e46000d6f308e", "image": { "url": "https://f4.bcbits.com/img/a1228029165_7.jpg" } }, { "dataType": "track", "title": "five finger death punch", "url": "https://remembertheotherguys.bandcamp.com/track/five-finger-death-punch?from=search&search_item_id=1328802397&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=16&search_sig=b01fde72732fc157ff7042c22095e00c", "image": { "url": "https://f4.bcbits.com/img/a2434658354_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch - The Devil's Own (Vocal Cover)", "url": "https://alonsoramirez.bandcamp.com/track/five-finger-death-punch-the-devils-own-vocal-cover?from=search&search_item_id=2432160278&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=17&search_sig=a8fdf34636fa2962a6d8321e7a43dcc1", "image": { "url": "https://f4.bcbits.com/img/a4056769363_7.jpg" } }, { "dataType": "track", "title": "Five Finger Death Punch- Wrong Side Of Heaven (Krooked Drivers Remix)", "url": "https://krookeddrivers.bandcamp.com/track/five-finger-death-punch-wrong-side-of-heaven-krooked-drivers-remix?from=search&search_item_id=2125398159&search_item_type=t&search_match_part=%3F&search_page_id=2567301701&search_page_no=1&search_rank=18&search_sig=12d8debf061c41b356ac27d0c3e317ba", "image": { "url": "https://f4.bcbits.com/img/a0716123876_7.jpg" } } ] } #### Album result json { "dataType": "album", "title": "N.A.T.I.O.N.", "url": "https://badwolves.bandcamp.com/album/n-a-t-i-o-n", "artist": { "name": "Bad Wolves", "url": "https://badwolves.bandcamp.com" }, "tags": [ { "title": "metal", "url": "https://bandcamp.com/tag/metal?from=tralbum&artist=924521020" }, { "title": "rock", "url": "https://bandcamp.com/tag/rock?from=tralbum&artist=924521020" }, { "title": "Los Angeles", "url": "https://bandcamp.com/tag/los-angeles?from=tralbum&artist=924521020" } ], "tracklist": [ { "title": "I'll Be There", "url": "https://badwolves.bandcamp.com/track/ill-be-there-1", "position": 1, "duration": "04:02" }, { "title": "No Messiah", "url": "https://badwolves.bandcamp.com/track/no-messiah", "position": 2, "duration": "04:20" }, { "title": "Learn To Walk Again", "url": "https://badwolves.bandcamp.com/track/learn-to-walk-again", "position": 3, "duration": "02:47" }, { "title": "Killing Me Slowly", "url": "https://badwolves.bandcamp.com/track/killing-me-slowly-1", "position": 4, "duration": "03:57" }, { "title": "Better Off This Way", "url": "https://badwolves.bandcamp.com/track/better-off-this-way", "position": 5, "duration": "03:22" }, { "title": "Foe Or Friend", "url": "https://badwolves.bandcamp.com/track/foe-or-friend", "position": 6, "duration": "03:26" }, { "title": "Sober", "url": "https://badwolves.bandcamp.com/track/sober-1", "position": 7, "duration": "03:15" }, { "title": "Back In The Days", "url": "https://badwolves.bandcamp.com/track/back-in-the-days", "position": 8, "duration": "03:43" }, { "title": "The Consumerist", "url": "https://badwolves.bandcamp.com/track/the-consumerist", "position": 9, "duration": "03:29" }, { "title": "Heaven So Heartless", "url": "https://badwolves.bandcamp.com/track/heaven-so-heartless", "position": 10, "duration": "03:35" }, { "title": "Crying Game", "url": "https://badwolves.bandcamp.com/track/crying-game-1", "position": 11, "duration": "03:11" }, { "title": "LA Song", "url": "https://badwolves.bandcamp.com/track/la-song", "position": 12, "duration": "03:33" } ], "images": [ { "url": "https://f4.bcbits.com/img/a0888598634_16.jpg" }, { "url": "https://f4.bcbits.com/img/a0888598634_10.jpg" } ] } #### Track result json { "dataType": "track", "title": "In The Dark", "url": "https://inflamesofficial.bandcamp.com/track/in-the-dark", "album": { "title": "Foregone", "url": "https://inflamesofficial.bandcamp.com/album/foregone" }, "artist": { "name": "In Flames", "url": "https://inflamesofficial.bandcamp.com" }, "duration": "04:17", "position": 9 }