https://github.com/idmja/soundy-api
https://github.com/idmja/soundy-api
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/idmja/soundy-api
- Owner: idMJA
- Created: 2025-02-27T17:08:07.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-02-28T10:58:51.000Z (3 months ago)
- Last Synced: 2025-02-28T14:43:38.893Z (3 months ago)
- Language: TypeScript
- Homepage: https://api.soundy.my.id
- Size: 204 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Soundy API
A modern API for music recommendations and sound processing built with Next.js. This API provides endpoints for getting music recommendations, similar tracks, and similar artists using the Last.fm API.
## Features
- Get top tracks by country
- Find similar tracks based on artist and track name
- Get similar artists recommendations
- OpenAPI documentation
- Multiple Last.fm API key support for load balancing
- Turborepo for faster builds
## Documentations
- [Click here to view the API documentation](https://api.soundy.my.id/)
## Getting Started
[](https://vercel.com/new/clone?repository-url=https://github.com/idMJA/soundy-api)
### Prerequisites
- Node.js 18+
- Last.fm API key(s)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/idMJA/soundy-api.git
cd soundy-api
```
2. Install dependencies:
```bash
npm install
# or
yarn install
# or
pnpm install
# or
bun install
```
3. Set your Last.fm API key(s) in the `.env` file.
4. Start the development server:
```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```
5. Access the API documentation at [http://localhost:3000/](http://localhost:3000/).