Search for releases
const url = 'https://example.com/api/v1/arr/releases?instanceId=1&itemId=1&season=1';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/api/v1/arr/releases?instanceId=1&itemId=1&season=1'Triggers an interactive search on an Arr instance and returns grouped/deduplicated results.
For Radarr: Searches for releases for the specified movie. For Sonarr: Searches for season pack releases for the specified series and season. For Lidarr: Searches for releases for the specified album.
Results are grouped by title, combining information from multiple indexers.
Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Arr instance ID
Movie ID (Radarr), Series ID (Sonarr), or Album ID (Lidarr)
Season number for Sonarr searches (defaults to 1)
Responses
Section titled “Responses”Release search results
object
Type of Arr instance
Total number of raw releases before grouping
Grouped and deduplicated releases
object
Release title
Release size in bytes
Languages detected in the release
Indexers where this release was found
Release flags (e.g., freeleech, internal)
Example
{ "type": "radarr"}Invalid or missing parameters
object
Error message
Examplegenerated
{ "error": "example"}Instance not found
object
Error message
Examplegenerated
{ "error": "example"}Failed to fetch releases
object
Error message
Examplegenerated
{ "error": "example"}