Browsing and Searching with Categories and Keywords

This section explains how to retrieve a feed of all of the videos that are in a particular category or that are associated with a particular keyword. The examples also demonstrate how you can retrieve videos that are associated with a category and one or more keywords as well; this will be done using the search feature of the MOVIECLIPS API.

The MOVIECLIPS API supports two different methods for retrieving videos that are in a particular category or that are labeled with a specific keyword.

• Use the following URL to retrieve videos that are in a specific category or that are labeled with a specific keyword or developer tag. If you know the entry url for the resource you want videos from (e.g Vertigo entry url is http://api.movieclips.com/v2/movies/2HLP4), you can access them like so:

http://api.movieclips.com/v2/movies/2HLP4/videos

• In the case you don’t use the resource url, but you know the name of the movie, you can get the list of videos by searching for the title in the movie category.

http://api.movieclips.com/v2/search/videos/movie=vertigo

• In the case where your request should span across two categories (e.g. mood = scary and prop = knife) your only option is to use the search feature.

http://api.movieclips.com/v2/search/videos/mood=scary~prop=knife