Synapticloop :: newznab API

Feeds

There are two types of feeds available through the API, personal feeds and site-wide feeds. Personal feeds relate to the user account (tied to the apikey), while site wide feeds are based on the latest indexed results.

Quick links

• Personal feed for:
  • My Cart
  • My Movies
  • My Shows

• Site wide feed for:
  • the latest indexed releases
  • an arbitrary category
  • the latest audio releases
  • the latest console releases
  • the latest movies releases
  • the latest other releases
  • the latest pc releases
  • the latest tv releases
  • the latest xxx releases

Personal Feeds

Personal feeds are specific to the API key that is passed through the request. The cart feed can be interacted with by adding and deleting, the MyMovies and MyShows can only be listed.

My Cart (getFeedForCart())

Retrieve the list of items that have been saved to your cart.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForCart {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForCart();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the cart: " + feedItem.getTitle());
		}

	}

}

see GetFeedForCart.java

My Movies (getFeedForMyMovies())

Retrieve the list of items that have been saved to the 'My Movies' section.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForMyMovies {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForMyMovies();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'my movies' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForMyMovies.java

My Shows (getFeedForMyShows())

Retrieve the list of items that have been saved to the 'My Shows' section.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForMyShows {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForMyShows();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'my shows' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForMyShows.java

Site-Wide Feeds

Site (getFeedForSite())

Retrieve the list of most recently indexed releases for the site, this includes all of the categories.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForSite {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForSite();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'site' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForSite.java NOTE: not all feeds are available on all indexers.

Category (getCategoryFeed(int category))

Retrieve the list of most recently indexed releases for a specific category, see the pre-defined categories. There is a list of pre-defined categories, which MOST, (if not all) indexers adhere to, however this cannot be guaranteed to be correct for every indexer. Use the getCapabilities() call to determine the categories and sub-categories for a specific indexer.

Also see the synapticloop.newznab.api.Category constants file for the pre-defined values.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.Category;
import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetCategoryFeed {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForCategory(Category.CATEGORY_AUDIO_LOSSLESS);

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item: " + feedItem.getTitle());
		}

	}

}

see GetCategoryFeed.java NOTE: not all feeds are available on all indexers.

Audio (getFeedForAudio())

Retrieve the list of most recently indexed releases for the audio category.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForAudio {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForAudio();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'audio' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForAudio.java NOTE: not all feeds are available on all indexers.

Console (getFeedForConsoles())

Retrieve the list of most recently indexed releases for the consoles category.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForConsoles {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForConsoles();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'console' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForConsoles.java NOTE: not all feeds are available on all indexers.

Movies (getFeedForMovies())

Retrieve the list of most recently indexed releases for the movies category.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForMovies {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForMovies();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'movies' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForMovies.java NOTE: not all feeds are available on all indexers.

Other (getFeedForOther())

Retrieve the list of most recently indexed releases for the other category - i.e. indexed releases that could not be fit into any other category.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForOther {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForOther();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'other' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForOther.java NOTE: not all feeds are available on all indexers.

PC (getFeedForPc())

Retrieve the list of most recently indexed releases for the PC category.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForPc {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForPc();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'PC' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForPc.java NOTE: not all feeds are available on all indexers.

TV (getFeedForTv())

Retrieve the list of most recently indexed releases for the TV category.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForTv {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForTv();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'TV' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForTv.java NOTE: not all feeds are available on all indexers.

XXX (adult-content) (getFeedForXXX())

Retrieve the list of most recently indexed releases for the XXX (adult) category.

import java.io.IOException;
import java.util.List;

import synapticloop.newznab.api.NewzNabApi;
import synapticloop.newznab.api.exception.NewzNabApiException;
import synapticloop.newznab.api.response.FeedResponse;
import synapticloop.newznab.api.response.model.FeedItem;

public class GetFeedForXXX {

	public static void main(String[] args) throws IOException, NewzNabApiException {
		NewzNabApi newzNabApi = new NewzNabApi("YOUR_API_URL", "YOUR_API_KEY");
		FeedResponse feedResponse = newzNabApi.getFeedForXXX();

		List feedItems = feedResponse.getFeedItems();
		for (FeedItem feedItem : feedItems) {
			System.out.println("Found an item in the 'XXX' section: " + feedItem.getTitle());
		}

	}

}

see GetFeedForXXX.java NOTE: not all feeds are available on all indexers.