IVA API    
 

Movie Available APIs

Listed below are all the various ways you can interact with our API:

VideoDetective Search
Description: List of VideoDetective selected items ordered by title
URL: http://www.videodetective.com/api/moviesearch.aspx?searchFor=1&Searchterm=1756&DeveloperId={Your DeveloperId}
Parameters:

    DeveloperId

    SearchFor = You may pass one of the following search options
         0 = Title - returns videos with matching title (STRING)
         1 = PublishedID - the unique id for a video (LONG)
         2 = ActorID - this will locate videos for a particular Actor (LONG)
         3 = StudioID - this will locate all media for a particular Studio (LONG)
         4 = Actor Name - this will locate all media for a particular Actor by name (STRING)
         5 = Studio - returns videos with matching studio (STRING)
         6 = Director - returns videos matching director (STRING)
         7 = Created Since - returns new videos >= date. (DATE)

    SearchTerm - Value of the item you want to find

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    View Flash Customization Parameters


Trailers Now In Theaters
Description: Generates a list ordered by date with theatrical releases within the last 30 days
URL: http://www.videodetective.com/api/intheaters.aspx?DeveloperId={Your DeveloperId}
Parameters:

    Randomize [true/false] - Let's you choose whether you want results randomized or not

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    DeveloperId

    View Flash Customization Parameters


Newly Added Videos
Description: List of all movies and DVD trailers added to VideoDetective.com
URL: http://www.videodetective.com/api/new.aspx?DeveloperId={Your DeveloperId}
Parameters:

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    DeveloperId

    View Flash Customization Parameters


Coming Soon To Theaters
Description: List ordered by date with theatrical releases from tomorrow's date on
URL: http://www.videodetective.com/api/comingtotheaters.aspx?DeveloperId={Your DeveloperId}
Parameters:

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    Randomize [true/false] - Let's you choose whether you want results randomized or not

    DeveloperId

    View Flash Customization Parameters


On DVD
Description: List ordered by date with dvd releases for the last 60 days
URL: http://www.videodetective.com/api/ondvd.aspx?DeveloperId={Your DeveloperId}
Parameters:

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    Randomize [true/false] - Let's you choose whether you want results randomized or not

    DeveloperId

    View Flash Customization Parameters


Coming Soon On DVD
Description: List ordered by date with dvd releases from tomorrow on
URL: http://www.videodetective.com/api/comingtodvd.aspx?DeveloperId={Your DeveloperId}
Parameters:

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    Randomize [true/false] - Let's you choose whether you want results randomized or not

    DeveloperId

    View Flash Customization Parameters


Top At The Box Office
Description: Top movies in theaters ordered by box office dollars
URL: http://www.videodetective.com/api/topboxoffice.aspx?DeveloperId={Your DeveloperId}
Parameters:

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    DeveloperId

    View Flash Customization Parameters


Anticipated Trailers Of Movies Coming Soon To Theaters
Description: Popular trailers coming soon to a theater near you
URL: http://www.videodetective.com/api/highlyanticipated.aspx?DeveloperId={Your DeveloperId}
Parameters:

    Page - Which page out of [PageSize] you would like to load

    PageSize - Size of [Page] that should be returned when querying the API

    Randomize [true/false] - Let's you choose whether you want results randomized or not

    DeveloperId

    View Flash Customization Parameters


Media RSS

You also have the option of retrieving data using the Media RSS format.

What is Media RSS?
Description: Media RSS is an extension of RSS developed to handle multiple media formats (video, audio, etc.) and also is capable of providing more metadata with the media beyond regular RSS. It is very widely supported by all major feed aggregators.

You can access our Media RSS feed for Music using this URL:

http://www.videodetective.com/api/MovieMediaRss.aspx?id=GenreID where GenreID can be:

    0 = Western
    1 = Action-Adventure
    2 = Children's
    3 = Comedy
    4 = Drama
    5 = Family
    6 = Horror
    7 = Musical
    8 = Mystery-Suspense
    9 = Non-Fiction
    10 = Sci-Fi
    11 = War
    12 = Health/Workout
    13 = Documentary
    14 = Thriller


    View Flash Customization Parameters


For more information as to what the resulting XML file contains, as well as how to customize our flash player, please see our API Quick Reference page.

Copyright © 2008 Internet Video Archive LLC