{"id":27157916,"url":"https://github.com/aryankeluskar/melodysyncer","last_synced_at":"2025-04-08T21:52:30.389Z","repository":{"id":209273888,"uuid":"723632246","full_name":"aryankeluskar/MelodySyncer","owner":"aryankeluskar","description":"Fastest ever API to convert Spotify songs or playlists to their Youtube equivalent. Utilizes an unique scoring system that minimizes searching credits and maximises accuracy.","archived":false,"fork":false,"pushed_at":"2025-01-23T21:49:17.000Z","size":1508,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-23T22:24:24.881Z","etag":null,"topics":["api","backend","fastapi","music","python"],"latest_commit_sha":null,"homepage":"https://dub.sh/melodysyncer","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aryankeluskar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-26T09:38:52.000Z","updated_at":"2025-01-23T21:49:20.000Z","dependencies_parsed_at":"2023-12-28T19:24:58.643Z","dependency_job_id":"9bc0f365-4904-4125-b177-80caf4be1a62","html_url":"https://github.com/aryankeluskar/MelodySyncer","commit_stats":null,"previous_names":["aryankeluskar/melodysyncer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aryankeluskar%2FMelodySyncer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aryankeluskar%2FMelodySyncer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aryankeluskar%2FMelodySyncer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aryankeluskar%2FMelodySyncer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aryankeluskar","download_url":"https://codeload.github.com/aryankeluskar/MelodySyncer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247934795,"owners_count":21020724,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","backend","fastapi","music","python"],"created_at":"2025-04-08T21:52:29.889Z","updated_at":"2025-04-08T21:52:30.382Z","avatar_url":"https://github.com/aryankeluskar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MelodySyncer - Most Accurate (and Fastest) Spotify to Youtube API Ever!\nBuilt using Python, FastAPI, hosted on Render.com \u003cbr\u003e MelodySyncer, or MeSo for short, is a Simple-to-use **Web API** to convert Spotify songs or playlists to their Youtube equivalent. Most Accurate since I have developed an unique scoring system that minimizes searching credits and maximises accuracy by factoring in Artist Name, Song Length, Album Name, Channel Source, etc. Takes only **0.2 seconds** per song! \n#### You get: _Skip manual searching, Directly get a List, Peace of Mind_ \u003cbr\u003e I get _(hopefully): Star, Heart, Follow :)_\n\n## Install (Only if local instance needed)\n    Requirements: gh, pip, python \u003c= 3.8\n    Run the following commands:\n    gh repo clone aryankeluskar/MelodySyncer\n    pip install -r requirements.txt\n  Also add the required details in .env\n\n\n## Run the app (Only if local instance needed)\n    uvicorn src.index:app --reload\nOpen your broswer at [http://localhost:8000](http://localhost:8000)\n\n## Usage\nVisit [dub.sh/melodysyncer](https://dub.sh/melodysyncer) to access this API. Check out detailed API documentation [here](https://melodysyncer.aryankeluskar.com/docs) generated with OpenAPI \u003cbr\u003e\n\n**Example**: `https://melodysyncer.aryankeluskar.com/playlist?query=7fITt66rmO4QIeNs2LPRDj\u0026youtubeAPIKEY=default` responds with [a list of YouTube Links](## \"can't reveal links in README for copyright purposes\") which can be processed with HttpRequest in Java, or requests.get in Python. This data can be stored in an Array or List for further processing.\n\n### GET /\n    Parameters: None \n    Response: (string) Displays the valid paths available, and frontend in the future\n    \n\u003chr\u003e\n\n### GET /song\n    Parameters: \n    - query (string): ID of the song in Spotify\n    - X-YouTube-API-Key (header, optional): Google Cloud API Key with YouTube Data v3 enabled\n    Response: (string) Accurate Youtube ID of the song, neglecting any remix, cover, and music videos\n    \n\u003chr\u003e\n\n### GET /playlist\n    Parameters: \n    - query (string): ID of the playlist in Spotify\n    - X-YouTube-API-Key (header, optional): Google Cloud API Key with YouTube Data v3 enabled\n    Response: (list of str) List / Array of Strings, each element contains the Youtube URL for the song. The indices remain same from Spotify Playlist\n\n## API Key Usage\nYou can provide the YouTube API key in two ways:\n1. As a query parameter: `?youtubeAPIKEY=YOUR_API_KEY`\n2. As a header: `X-YouTube-API-Key: YOUR_API_KEY`\n\nIf no API key is provided, the server will use its default API key which has a limited trial.\n\n## Support this project!\n### This is my second ever API! Please consider leaving a 🌟 if this added value to your wonderful project\n### Made with pure love and [freshman fascination](## \"it's a real term i swear\"). Visit my website at [aryankeluskar.github.io](https://aryankeluskar.github.io) \u003c3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faryankeluskar%2Fmelodysyncer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faryankeluskar%2Fmelodysyncer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faryankeluskar%2Fmelodysyncer/lists"}