Songstats api

this project is an application which uses/scraps the intern api from songstats .com which is an website where multiple data sources like (spotify,youtube,deezer) ar bundled for alot of artists

the provided api from songstats isn't free so i built a small app which lets you host your own api based upon the data provided by the songstats api

First you scrap the data from the artists u need.

Then you start an express.js API to make the files available for further processing

Howto

• specify artists in /server/data/loadArtists.json
  • available sources = spotify |apple_music | amazon | deezer | instagram | tiktok | youtube | shazam | tracklist | beatport | soundcloud | facebook | itunes
    • and more. Check the songstats website to find more
• run npm run scrap
  • this will scrap an copy all the data from songstats
  • you can also reduce the delay between each request to speed up the process
    • be carefull you can mybe get softbanned from the website when delay to short
• specify/edit .env file to your needs
  • copy .env-template and rename
• after the scrap.js script finished run npm run start

for dev

• use npm run dev
  • this will reload the application as soon as .js files change

Routes

Route	returns	live
/artists/list	./server/data/loadArtists.json	/artists/list
/artists/get/< artist_name >	./server/data/artists/< artist_name >.json	/artists/get/amelie-lens
/artists/source/< artist_name >/< source >	< source > from ./server/data/artists/< artist_name >.json	/artists/source/amelie-lens/spotify

more Config

• to force rescraping delete all .json files in ./server/data/artists/
• you can specify in .env file
  • DELAY_BETWEEN_CACHE_INVALID = after how many seconds the cached artist data files gets invalidated and needs to be refetched
  • DELAY_BETWEEN_SOURCE = delay between each source request

Future plans

• add cron job which retry scrap every n hours