{"id":49453672,"url":"https://github.com/echonest/jEN","last_synced_at":"2026-06-02T05:00:45.902Z","repository":{"id":6411020,"uuid":"7649304","full_name":"echonest/jEN","owner":"echonest","description":"the java client for The Echo Nest API","archived":false,"fork":false,"pushed_at":"2016-01-25T21:49:49.000Z","size":4626,"stargazers_count":67,"open_issues_count":11,"forks_count":43,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-03-26T01:36:38.318Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/echonest.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}},"created_at":"2013-01-16T16:33:47.000Z","updated_at":"2024-02-01T23:51:16.000Z","dependencies_parsed_at":"2022-09-24T05:00:52.762Z","dependency_job_id":null,"html_url":"https://github.com/echonest/jEN","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/echonest/jEN","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echonest%2FjEN","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echonest%2FjEN/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echonest%2FjEN/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echonest%2FjEN/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/echonest","download_url":"https://codeload.github.com/echonest/jEN/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echonest%2FjEN/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33806987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2026-04-30T04:01:03.703Z","updated_at":"2026-06-02T05:00:45.895Z","avatar_url":"https://github.com/echonest.png","language":"Java","funding_links":[],"categories":["📦 Legacy \u0026 Inactive Projects"],"sub_categories":[],"readme":"# jEN \n\njEN is an open source Java library for the [Echo Nest API](http://developer.echonest.com/docs/v4/). \n\n# Quick Start\n\n  * Download the [latest distribution](http://static.echonest.com.s3.amazonaws.com/jEN/files/jEN-latest.zip)\n  * Read the extensive [Javadocs for jEN](http://static.echonest.com.s3.amazonaws.com/jEN/javadoc/index.html)\n  * Browse the [examples](https://github.com/echonest/jEN/tree/master/src/com/echonest/api/v4/examples)\n\n# What is it?\n\n* jEN is an open source Java library for the Echo Nest API. With jEN you have Java\naccess to the entire set of API methods including:\n\n* **artist** - search for artists by name, description, or attribute, and get\n  back detailed information about any artist including audio, similar artists,\n  blogs, familiarity, hotttnesss, news, reviews, urls and video.\n* **song** - search songs by artist, title, description, or attribute (tempo,\n  duration, etc) and get detailed information back about each song, such as\n  hotttnesss, audio summary, or tracks.\n* **track** - upload a track to the Echo Nest and receive summary information\n  about the track including key, duration, mode, tempo, time signature along\n  with detailed track info including timbre, pitch, rhythm and loudness\n  information.\n* **playlists** - create personalized playlists based on a wide range of parameters\n* **taste profiles** - provide for personalized recommendation and playlisting\n\nThis is a Java client API and assorted tools and helpers for the Echo Nest API (at developer.echonest.com). This\nclient works with Version 4 of the Echo Nest API.\n\n## Artist Methods\nSome of the Echo Nest artist capabilities:\n\n * search for artists\n * get familiarity and hotttness of an artist\n * get a list of the hottest artists\n * get news about an artist\n * get bios for an artist\n * get reviews about an artist\n * get blogs about an artist\n * get terms about an artist\n * get similar artists\n * get genre info about an artist\n * get artist location info about an artist\n * get years active info about an artist\n * get urls for an artist\n * get video for an artist\n * get images for an artist\n * get artist ids for other services such as Facebook, Twitter, Rdio, Spotify, Rhapsody and many more\n\n## Song methods\nSome of the Echo Nest track capabilities:\n\n * search for songs\n * get info about a song including:\n    * tempo\n    * energy\n    * danceability\n    * loudness\n    * liveness\n    * speechiness\n * detailed audio analysis\n * song hotttnesss\n * artist hotttnesss\n * artist familiarity\n * artist location\n\n## Playlist Methods\n * create Pandora-style artist radio playlists\n * create Genre Radio Playlists\n * create dynamic playlists that respond to the users explicit and implicit feedback\n\n## Taste Profile Methods\n * create, read, update and delete taste info for a particular user\n * use a taste profile to seed playlists to give peronalized playlists\n\n# Getting Started\n * download the latest release\n * unzip the archive\n * add the jEN.jar file to your CLASSPATH\n * get an API key from [developer.echonest.com](http://developer.echonest.com)\n * Browse the Javadocs included with the distribution\n\n## Quick Start\nHere's some sample code that shows how to get similar artists with the API:\n\n    public static void main(String[] args) throws EchoNestException {\n        EchoNestAPI echoNest = new EchoNestAPI(API_KEY);\n        List\u003cArtist\u003e artists = echoNest.searchArtists(\"Weezer\");\n\n        if (artists.size() \u003e 0) {\n            Artist weezer = artists.get(0);\n            System.out.println(\"Similar artists for \" + weezer.getName());\n            for (Artist simArtist : weezer.getSimilar(10)) {\n                System.out.println(\"   \" + simArtist.getName());\n            }\n        }\n    }\n\n\n\n# Code Examples\nBrowse some of the code [examples](https://github.com/echonest/jEN/tree/master/src/com/echonest/api/v4/examples)\n\n# Building the jar file\nGrab the source, cd to the top leve directory and issue:\n\n    % ant jar\n\n# Running a test shell\n\nIncluded with the API is a command line interface to the Echo Nest\nAPI. You can use this shell to interact with the Echo Nest.  To run\nthe shell invoke the 'enshell' script, or run the command:\n\njava -DECHO_NEST_API_KEY=$MY_ECHO_NEST_KEY -jar jEN.jar \n\nType 'help' to show the list of available commands.  Try some:\n\n    % scripts/enshell\n      Welcome to The Echo Nest API Shell\n      type 'help' \n\n    nest% get_similar weezer\n\n    Similarity for Weezer\n      Rivers Cuomo\n      The Rentals\n      Fountains of Wayne\n      Jimmy Eat World\n      Phantom Planet\n      The Presidents of the United States of America\n      Cake\n      Harvey Danger\n      The All-American Rejects\n      Ben Folds Five\n      Nerf Herder\n      Motion City Soundtrack\n      New Found Glory\n      Superdrag\n      Foo Fighters\n\n    nest% splaylist Muse\n\n        Muse Time = Is Running Out\n        Coldplay = Viva La Vida\n        Travis = Sing\n        The Killers = Here With Me\n        The Subways = I Want To Hear What You Have Got To Say\n        Bloc Party = Banquet\n        Keane = Is It Any Wonder?\n        The Cooper Temple Clause = Talking To A Brick Wall\n        Richard Ashcroft = Check The Meaning\n        Athlete Wires = (Album Version)\n\n    nest% \n\n# Release History\n\n  * Jan 18, 2013 [jEN-4.x.t.zip](http://static.echonest.com.s3.amazonaws.com/jEN/files/jEN-4.x.t.zip)\n      * Added more examples\n      * Fixed throttle code on API error\n      * Improved deploy\n  * Jan 16, 2013 [jEN-4.x.s.zip](http://static.echonest.com.s3.amazonaws.com/jEN/files/jEN-4.x.s.zip)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fechonest%2FjEN","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fechonest%2FjEN","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fechonest%2FjEN/lists"}