{"id":13576928,"url":"https://github.com/0xVasconcelos/TidalAPI","last_synced_at":"2025-04-05T09:30:32.668Z","repository":{"id":48124749,"uuid":"51041340","full_name":"0xVasconcelos/TidalAPI","owner":"0xVasconcelos","description":"Unofficial Node.js TIDAL API","archived":false,"fork":false,"pushed_at":"2021-02-17T21:16:36.000Z","size":37,"stargazers_count":211,"open_issues_count":12,"forks_count":45,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-03-24T12:04:41.006Z","etag":null,"topics":["nodejs","tidal","tidalapi"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xVasconcelos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-04T00:32:30.000Z","updated_at":"2025-03-15T00:29:30.000Z","dependencies_parsed_at":"2022-08-12T19:10:14.309Z","dependency_job_id":null,"html_url":"https://github.com/0xVasconcelos/TidalAPI","commit_stats":null,"previous_names":["0xvasconcelos/tidalapi","lucaslg26/tidalapi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xVasconcelos%2FTidalAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xVasconcelos%2FTidalAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xVasconcelos%2FTidalAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xVasconcelos%2FTidalAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xVasconcelos","download_url":"https://codeload.github.com/0xVasconcelos/TidalAPI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247317887,"owners_count":20919444,"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":["nodejs","tidal","tidalapi"],"created_at":"2024-08-01T15:01:15.960Z","updated_at":"2025-04-05T09:30:32.660Z","avatar_url":"https://github.com/0xVasconcelos.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# TidalAPI\n\n[![Build Status](https://img.shields.io/travis/lucaslg26/TidalAPI.svg)](https://travis-ci.org/lucaslg26/TidalAPI) [![npm version](http://img.shields.io/npm/v/tidalapi.svg)](https://npmjs.org/package/tidalapi) [![npm downloads](https://img.shields.io/npm/dm/tidalapi.svg)](https://npmjs.org/package/tidalapi) [![NPM](https://img.shields.io/npm/l/tidalapi.svg)](https://github.com/lucaslg26/TidalAPI/blob/master/LICENSE.md) [![David](https://img.shields.io/david/lucaslg26/TidalAPI.svg)](https://david-dm.org/lucaslg26/TidalAPI)\n\n## About\n\nnode.js TIDAL API. Use the TIDAL Web API simply using this module ;)\n\nCreated by [Lucas Vasconcelos](https://github.com/lucaslg26)\n\n**NOTE:** Currently not supporting facebook login.\n\n## How to use\nRun the following:\n\n``` javascript\nnpm install tidalapi\n```\n\n## Obtain the Tidal token needed to use this API\n\nAs well as a TIDAL username and password, the Tidal API needs an API `token` which is unique to your apps. You can get this token by network-sniffing some application that uses TIDAL Playback feature, like Tidal for Windows, Tidal for Android, or CapTune from Sennheiser.\n\n### Obtaining a token from TIDAL for Windows\n\n - Install [Fiddler](https://www.telerik.com/download/fiddler) and start it.\n - In Fiddler, click **Tools** \u003e **Options** \u003e **Decrypt HTTPS Traffic**\n - Install TIDAL for Windows and start it\n - In Fiddler, look for requests to `api.tidal.com`. Click a request, then on the right, click **Inspectors** \u003e **Headers**. Underneath **Miscellaneous** you'll see `X-Tidal-Token`. This is a TIDAL Token you can use.\n\n\u003cimg src=\"https://i.imgur.com/SvBgcIV.png\"\u003e\n\n## Usage\n\nSimple usage searching and querying a track list\n\n```javascript\nvar TidalAPI = require('tidalapi');\n\nvar api = new TidalAPI({\n  username: 'your-username-here',\n  password: 'your-password-here',\n  token: 'your-token-here',\n  // Could also be 'LOSSLESS' but this only supported on premium subscriptions\n  quality: 'HIGH'\n});\n```\n\n### Search\n\n```javascript\napi.search({type: 'artists', query: 'Dream Theater', limit: 1}, function(data){\n  console.log(data.artists);\n})\n\napi.search({type: 'albums', query: 'Dream Theater', limit: 1}, function(data){\n  console.log(data.albums);\n})\n\napi.search({type: 'tracks', query: 'Dream Theater', limit: 1}, function(data){\n  console.log(data.tracks);\n})\n\napi.search({type: 'tracks,albums,artists', query: 'Dream Theater', limit: 1}, function(data){\n  console.log(data.tracks);\n  console.log(data.albums);\n  console.log(data.artists);\n})\n```\n\n### Track info\n\n```javascript\napi.getTrackInfo({id: 22560696 }, function(data){\n  console.log(data)\n})\n```\n\n### Streams\n\n```javascript\napi.getStreamURL({id: 22560696}, function(data){\n  console.log(data)\n})\n\napi.getVideoStreamURL({id: 25470315}, function(data){\n  console.log(data)\n})\n```\n\n### Album Art\n\n```javascript\nconsole.log(api.getArtURL('24f52ab0-e7d6-414d-a650-20a4c686aa57', 1280)) //coverid\n```\n\n### Videos\n\n```javascript\napi.getArtistVideos({id: 14670, limit: 2}, function(data){\n  console.log(data)\n})\n```\n\n### FLAC tags\n\n```javascript\napi.genMetaflacTags({id: 22560696, coverPath: './albumart.jpg', songPath: './song.flac'}, function(data){\n  console.log(data)\n  /* --remove-all-tags --set-tag=\"ARTIST=Dream Theater\" --set-tag=\"TITLE=Along For The Ride\" --set-tag=\"ALBUM=Dream Theater\" --set-tag=\"TRACKNUMBER=8\" --set-tag=\"COPYRIGHT=2013 Roadrunner Records, Inc.\" -set-tag=\"DATE=2013\" --import-picture-from=\"./albumart.jpg\" \"./song.flac\" --add-replay-gain */\n})\n```\n\n## Troubleshooting\n\n### 500 error with 'Ooops, an unexpected error occurred'\n\nYour TIDAL token is likely incorrect.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xVasconcelos%2FTidalAPI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xVasconcelos%2FTidalAPI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xVasconcelos%2FTidalAPI/lists"}