beatport

A REST API to follow the most hyped tracks on the dance floors 🎶 👯

This project has no link with beatport.com. It's just an open source project to facilitate the search for tracks through an API.

Getting Started

Requirements

Golang (14.0 or higher)
GNU Make
Docker

Setting up and running locally

# Install dependencies
make install

# Run server
make run

Running the tests

make test

Build process

Build

make build

Create a Docker image

make image

Running the app using Docker

make run-docker

Sample

Genres

Get all available genres on Beatport:

GET /genres

[
    {
        "name": "Afro House",
        "key": "afro-house-89",
        "url": "https://www.beatport.com/genre/afro-house/89"
    },
    {
        "name": "Bass House",
        "key": "bass-house-91",
        "url": "https://www.beatport.com/genre/bass-house/91"
    },
...
]

Tracks

TOP 10

Get the top 10 tracks by a genre key:

GET /tracks/top10/:genreKey

[
    {
        "chartNumber": 1,
        "title": "Mona Ki Ngi Xica",
        "remix": "Pablo Fierro Remix",
        "artists": [
            "Pablo Fierro",
            "Bonga"
        ],
        "label": "MoBlack Records",
        "genre": "Afro House",
        "url": "https://www.beatport.com/track/mona-ki-ngi-xica-pablo-fierro-remix/14279156",
        "price": "1.29"
    },
    {
        "chartNumber": 2,
        "title": "Feeling Good",
        "remix": "Original Mix",
        "artists": [
            "Javi Colors",
            "Dr. Alfred"
        ],
        "label": "SP Recordings",
        "genre": "Afro House",
        "url": "https://www.beatport.com/track/feeling-good-original-mix/13781081",
        "price": "1.29"
    },
...
]

jeanmorais/beatport