AnyClip API‎ > ‎

API Methods


getMethods
Returns full list of API methods and its parameters.

Example
http://apis.anyclip.com/api/application.wadl?cid=[cid]&format=XML&sig=[sig]


getAutocompleteEntities

Returns auto-complete entries for cast and titles.

Use with custom players to receive the video URL to play the clip.

userID = unique identifier of the flash player instance

Path

Parameters

Type

Bitwise Value

Item

Notes

/autocomplete/

q

string

 

unique name

 

efliter

long

1

Title


long

2

Cast

actor or director

 userID  string  player id      Use userID with custom player if you  want to filter results by country or view quota restrictions.

   userID = unique identifier of the flash player instance

Example

http://apis.anyclip.com/api/autocomplete/?cid=[cid]&format=JSON&q=tom&sig=[sig]
c=code
n=name
t=type[actor or director]
un=unique-name

{ "cast":
  [ { "c": "psKh66cJQ"
    , "n": "Tom Abernethy"
    , "t": "Actor"
    , "un": "tom-abernethy"
    }
  , { "c": "p1LQdlBXF"
    , "n": "Tom Adams"
    , "t": "Actor"
    , "un": "tom-adams"
    }
  , { "c": "pUt7kmijQ"
    , "n": "Tom Ahearne"
    , "t": "Actor"
    , "un": "tom-ahearne"
    }
  , { "c": "pI2hShHug"
    , "n": "Tom Aldredge"
    , "t": "Actor"
    , "un": "tom-aldredge"
    }
  , { "c": "pFIHkbKoZ"
    , "n": "Tom Allen"
    , "t": "Actor"
    , "un": "tom-allen"
    }
  ]
, "titles":
  [ { "c": "tE4GvNsNP"
    , "n": "Tomb Raider"
    , "un": "lara-croft-tomb-raider"
    }
  , { "c": "t3LE2JY1t"
    , "n": "Tomcats"
    , "un": "tomcats"
    }
  , { "c": "tFuLyB6h4"
    , "n": "Tommy Boy"
    , "un": "tommy-boy"
    }
  , { "c": "tPyBRlO1x"
    , "n": "Tomorrow Never Dies"
    , "un": "tomorrow-never-dies"
    }
  ]
}

getItem

Gets an individual actor, clip, director, or title. 

In addition to parameters listed below, startIndex and maxResults parameters can be added. These parameters used for pagination of multi-valued properties, e.g. featured clips or locations. Default values is startIndex=0 and maxResults=5.

PathParam - value is not part of query, but should be inserted into request path.

tf=title filter

Path

Parameters

Type

Bitwise Value

Item

Notes

/actor/[id]/

id

PathParam, string

 

required

id=code or unique-name.

filter

long

1

Poster

 

2

URL

 

4

Bio

 

8

Life Dates

 

16

Featured Clips

 

32

Roles

 

64

Default (most viewed) clip

 

/clip/[id]/

id

PathParam, string

 

required

id=code or unique name

titleId

string


movie code

id= code or unique name

filter

long

1

Thumbnail

 

2

URL

 

4

Actors

 

8

Restrictions

adult or soundtrack

16

Buy links

 

32

Video URL

 

64

Clip type

cult, memorable, standard

128

Views

number of times the clip has been viewed

256

No title

returns results without the title object

512

Short URL

 

1024

Quotes

quotes in the clip

2048

Tags

 

4096

-

 Reserved

16384

Locations

Meta-data related to Locations in the clip

32768

Like/Dislike

Number of Likes and Dislikes for that clip

65536

Video Content Data

Metadata of clip's video file. For example video and audio codec.

userID

string

 

 player id

Use with custom players to receive the video URL to play the clip.

userID = unique identifier of the flash player instance

tf

long

1 ... 8388608


 Similar to 'filter' parameter in /title/ method.

/clip/[id]/next/

parameters are similar to /clip/[id]/ method

Clip after clip with given id

/clip/[id]/prev/

parameters are similar to /clip/[id]/ method

Clip before clip with given id

/director/[id]/

id

PathParam, string

 

required

id=code or unique-name

filter

long

1

Poster

 

2

URL

 

4

Bio

 

8

Life_Dates

 

16

Featured_Clips

 

32

Titles

 

64

Default (most viewed) clip

 

/title/[id]/

id

PathParam, string

 

required

id=code or unique-name

filter

long

1

Poster

 

2

URL

 

4

Plot

 

8

Release_date, Duration and Studio_id

Release_date and Duration = Unix time in milliseconds

16

Featured_clips

 

32

Directors

 

64

Actors

 

128

Buy_Links

 

256

External_Videos

URL that is not an AnyClip resource

 512  Genres  
 1024  Tags  Most popular metadata attributes and its count. 
 For example:
[ { "count" : "4", "val" : "armor" },
{ "count" : "5", "val" : "us flag" } ]
 2048  Reserved  
 4096  Reserved  
 8192
 Reserved  
 16384  Locations  Coordinates or foursquare venues of places
 where the movie was filmed or its plot takes
 place.
 32768  Music  soundtrack data
 65536      Characters  List of movie characters with code of actor
 for every character
 131072  Brands  Barand appearing in movie,
 e.g. Coca-Cola or Ford
 262144   Default (most viewed) clip  
 524288  Video Content Data  Video metadata. For example video and audio codec.
 1048576  Reserved  
 2097152  Video URL  
 4194404  Reserved  


Examples

get Actor filter=2 (url)

http://apis.anyclip.com/api/actor/tom-cruise/?cid=[cid]&filter=2&format=JSON&sig=[sig]

{

    * code: "pjxasVq7o"
    * name: "Tom Cruise"
    * uniqueName: "tom-cruise"
    * url: http://anyclip.com/actors/tom-cruise/

}

get Clip

http://apis.anyclip.com/api/clip/ucNlut2Y7h2mb/?cid=[cid]&format=JSON&sig=[sid]

{ "code": "ucNlut2Y7h2mb"
, "duration": "30100"
, "thumbnail": "http://thumbs.anyclip.com/t5MhxzNip/tmb_5640_480.jpg"
, "timeIn": "5639800"
, "timeOut": "5669900"
, "title":
  { "buyLinks":
    [ { "store": "Amazon"
      , "url": "http://www.amazon.com/Lock-Stock-Smoking-Barrels-Widescreen/dp/B00007ELEP?SubscriptionId=AKIAIGC7VREOKSBROLJA&tag=ws&linkCode=xm2&camp=2025&creative=165953&creativeASIN=B00007ELEP"
      }
    , { "store": "ITunes"
      , "url": "http://click.linksynergy.com/fs-bin/click?id=8nnyZa0aYwQ&subid=0&offerid=146261.1&type=10&tmpid=3909&RD_PARM1=http%3A%2F%2Fitunes.apple.com%2FWebObjects%2FMZStore.woa%2Fwa%2FviewMovie%3Fid%3D281827014%2526s%3D143441%2526uo%3D6"
      }
    , { "store": "Netflix"
      , "url": "http://www.netflix.com/Movie/Lock_Stock_and_Two_Smoking_Barrels/16944044"
      }
    ]
  , "code": "t5MhxzNip"
  , "name": "Lock, Stock and Two Smoking Barrels"
  , "uniqueName": "lock-stock-and-two-smoking-barrels"
  }
, "urls":
  [ { "type": "Regular"
    , "url": "http://anyclip.com/movies/lock-stock-and-two-smoking-barrels/ucNlut2Y7h2mb/ "
    }
  ]
}

get Clip filter=4 (actors)

http://apis.anyclip.com/api/clip/ucNlut2Y7h2mb/?cid=[cid]&filter=4&format=JSON&sig=[sig]

{ "actors":
  [ { "code": "puqOvjGfD"
    , "name": "Nick Moran"
    , "uniqueName": "nick-moran"
    }
  , { "code": "pyvkHEp4C"
    , "name": "Jason Statham"
    , "uniqueName": "jason-statham"
    }
  , { "code": "pdxLjhCSA"
    , "name": "Dexter Fletcher"
    , "uniqueName": "dexter-fletcher"
    }
  , { "code": "p7g4VZFUn"
    , "name": "Jason Flemyng"
    , "uniqueName": "jason-flemyng"
    }
  ]
, "code": "ucNlut2Y7h2mb"
, "duration": "30100"
, "timeIn": "5639800"
, "timeOut": "5669900"
, "title":
  { "code": "t5MhxzNip"
  , "name": "Lock, Stock and Two Smoking Barrels"
  , "uniqueName": "lock-stock-and-two-smoking-barrels"
  }
}

get Clip tf=4 (title filter=plot)

http://apis.anyclip.com/api/clip/ucNlut2Y7h2mb/?cid=[cid]&format=JSON&sig=[sig]&tf=4

{ "code": "ucNlut2Y7h2mb"
, "duration": "30100"
, "thumbnail": "http://thumbs.anyclip.com/t5MhxzNip/tmb_5640_480.jpg"
, "timeIn": "5639800"
, "timeOut": "5669900"
, "title":
  { "buyLinks":
    [ { "store": "Amazon"
      , "url": "http://www.amazon.com/Lock-Stock-Smoking-Barrels-Widescreen/dp/B00007ELEP?SubscriptionId=AKIAIGC7VREOKSBROLJA&tag=ws&linkCode=xm2&camp=2025&creative=165953&creativeASIN=B00007ELEP"
      }
    , { "store": "ITunes"
      , "url": "http://click.linksynergy.com/fs-bin/click?id=8nnyZa0aYwQ&subid=0&offerid=146261.1&type=10&tmpid=3909&RD_PARM1=http%3A%2F%2Fitunes.apple.com%2FWebObjects%2FMZStore.woa%2Fwa%2FviewMovie%3Fid%3D281827014%2526s%3D143441%2526uo%3D6"
      }
    , { "store": "Netflix"
      , "url": "http://www.netflix.com/Movie/Lock_Stock_and_Two_Smoking_Barrels/16944044"
      }
    ]
  , "code": "t5MhxzNip"
  , "name": "Lock, Stock and Two Smoking Barrels"
  , "plots":
    { "source": "http://www.imdb.com/title/tt0120735/plotsummary"
    , "text": "Four London working class stiffs pool their money to put one in a high stakes card game, but things go wrong and they end up owing half a million pounds and having one week to come up with the cash."
    , "type": "IMDB"
    }
  , "uniqueName": "lock-stock-and-two-smoking-barrels"
  }
, "urls":
  [ { "type": "Regular"
    , "url": "http://anyclip.com/movies/lock-stock-and-two-smoking-barrels/ucNlut2Y7h2mb/ "
    }
  ]
}

get Director filter=4 (bio)

http://apis.anyclip.com/api/director/martin-scorsese?cid=[cid]&filter=4&format=JSON&sig=[sig]

{ "bios":
  { "source": "http://www.freebase.com/view/en/martin_scorsese"
  , "text": "<p>Martin C. Scorsese (pronounced&#160;/sk&#596;r&#712;s&#603;si/; born November 17, 1942) is an American film director, screenwriter, producer, actor, and film historian. He is the founder of the World Cinema Foundation and a recipient of the AFI Life Achievement Award for his contributions to the cinema, and has won awards from the Oscars, Golden Globe, BAFTA, and Directors Guild of America. Scorsese is president of The Film Foundation, a nonprofit organization dedicated to film preservation.\nScorsese's body of work addresses such themes as Italian-American identity, Roman Catholic concepts of guilt and redemption, machismo, and violence. Scorsese is widely considered to be one of the most significant and influential American filmmakers of his era, directing landmark films such as Taxi Driver, Raging Bull and Goodfellas &#8211; all of which he collaborated on with actor and close friend Robert De Niro. He won the Academy Award for Best Director for The Departed and earned an MFA in film directing from the New...</p>"
  , "type": "Freebase"
  }
, "code": "p0H3loaG1"
, "name": "Martin Scorsese"
, "uniqueName": "martin-scorsese"
}

get Director filter=32 (titles)

http://apis.anyclip.com/api/director/martin-scorsese/?cid=[cid]&filter=32&format=JSON&sig=[sig]

{ "code": "p0H3loaG1"
, "name": "Martin Scorsese"
, "titles":
  [ { "code": "tHKKbDzi6"
    , "name": "Goodfellas"
    , "poster": "http://img.anyclip.com/posters/tHKKbDzi6_200.jpg"
    , "uniqueName": "goodfellas"
    , "url": "http://anyclip.com/movies/goodfellas/"
    }
  , { "code": "tMxtmup2e"
    , "name": "Departed, The"
    , "poster": "http://img.anyclip.com/posters/tMxtmup2e_200.jpg"
    , "uniqueName": "the-departed"
    , "url": "http://anyclip.com/movies/the-departed/"
    }
  , { "code": "tHksmDLt1"
    , "name": "Casino"
    , "poster": "http://img.anyclip.com/posters/tHksmDLt1_200.jpg"
    , "uniqueName": "casino"
    , "url": "http://anyclip.com/movies/casino/"
    }
  , { "code": "tbEx0HUgJ"
    , "name": "Raging Bull"
    , "poster": "http://img.anyclip.com/posters/tbEx0HUgJ_200.jpg"
    , "uniqueName": "raging-bull"
    , "url": "http://anyclip.com/movies/raging-bull/"
    }
  , { "code": "tscWrH3NA"
    , "name": "Taxi Driver"
    , "poster": "http://img.anyclip.com/posters/tscWrH3NA_200.jpg"
    , "uniqueName": "taxi-driver"
    , "url": "http://anyclip.com/movies/taxi-driver/"
    }
  ]
, "uniqueName": "martin-scorsese"
}

get Title filter=72 (actors 64 + release date 8)

http://apis.anyclip.com/api/title/goodfellas/?cid=[cid]&filter=72&format=JSON&sig=[sig]

{ "actors":
  [ { "code": "pzVR2wJnr"
    , "name": "Robert De Niro"
    , "uniqueName": "robert-de-niro"
    , "url": "http://anyclip.com/actors/robert-de-niro/"
    }
  , { "code": "pZKtPGf5j"
    , "name": "Ray Liotta"
    , "uniqueName": "ray-liotta"
    , "url": "http://anyclip.com/actors/ray-liotta/"
    }
  , { "code": "piArDiEwi"
    , "name": "Joe Pesci"
    , "uniqueName": "joe-pesci"
    , "url": "http://anyclip.com/actors/joe-pesci/"
    }
  , { "code": "pDKS3Reux"
    , "name": "Lorraine Bracco"
    , "uniqueName": "lorraine-bracco"
    , "url": "http://anyclip.com/actors/lorraine-bracco/"
    }
  , { "code": "pHuLxGhkF"
    , "name": "Paul Sorvino"
    , "uniqueName": "paul-sorvino"
    , "url": "http://anyclip.com/actors/paul-sorvino/"
    }
  ]
, "code": "tHKKbDzi6"
, "name": "Goodfellas"
, "releaseDate": "631152000000"
, "uniqueName": "goodfellas"
}

getItems

Returns multiple actors, clips, directors, or titles. List of IDs used for all entity types. Titles can be also choosen by genre or franchise.

Use startIndex and maxResults for pagination, otherwise total items count is limited to no more than 5.

max maxResult=24

tf=title filter

Path

Parameters

Type

Item

Notes

/actors/

id

string

required

id=[code or unique name]

id=[id]&id=[id]&id=[id]

 userID  string  player id      Use userID with custom player if you  want to filter results by country or view quota restrictions.

   userID = unique identifier of the flash player instance

filter

similar to /actor/ method

/clips/

id

string

required

id=[code or unique name]

id=[id]&id=[id]&id=[id]

 userID  string  player id      Use userID with custom player if you  want to filter results by country or view quota restrictions.

   userID = unique identifier of the flash player instance

filter

similar to /clip/ method

tf

similar to 'filter' parameter in /title/ method

/directors/

id

string

required

id=[code or unique name]

id=[id]&id=[id]&id=[id]

filter

similar to /director/ method

 userID  string  player id      Use userID with custom player if you  want to filter results by country or view quota restrictions.

   userID = unique identifier of the flash player instance

/titles/

id

string

required

id=[code or unique name]

id=[id]&id=[id]&id=[id]

filter

similar to /title/ method

 userID  string  player id      Use userID with custom player if you  want to filter results by country or view quota restrictions.

   userID = unique identifier of the flash player instance

/genres/[id]/titles/

id

int

required, genre id

Use /genres/list/ method to get genre id

filter

similar to /title/ method

/franchises/[id]/titles/

id

int

required, franchise id

Use /franchises/list/ method to get franchise id

filter

similar to /title/ method

Example: get Titles

titles= The Matrix and Gladiator

http://apis.anyclip.com/api/titles?cid=[cid]&format=JSON&id=the-matrix&id=gladiator&sig=[sig]

{ "result":
  [ { "@type": "title"
    , "code": "tzdBPyEwr"
    , "name": "Matrix, The"
    , "uniqueName": "the-matrix"
    },
    { "@type": "title"
    , "code": "tGyjzRLzw"
    , "name": "Gladiator"
    , "uniqueName": "gladiator"
    }
  ]
, "totalItemsCount": "2"
}

getPopular

Returns clips with the highest view counts.
tf=title filter
af=actors filter

Path

Parameters

Notes

 /clips/popular/

filter

Similar to /clip/ method

tf

Similar to 'filter' parameter in /title/ method. Used when movies the clips belong to are returned.

af

Similar to 'filter' parameter in  /actor/ method. Used when actors participating in the clips are returned.

 /actors/popular/   filter  Similar to /actor/ method

Examples

Clips (no filters)

http://apis.anyclip.com/api/clips/popular/?cid=[cid]&format=JSON&sig=[sig]

{ "result":
  [ { "@type": "clip"
    , "code": "F8pWu44tbhbJmb"
    , "duration": "120100"
    , "thumbnail": "http://thumbs.anyclip.com/tGyjzRLzw/tmb_5450_480.jpg"
    , "timeIn": "5446100"
    , "timeOut": "5566200"
    , "title":
      { "code": "tGyjzRLzw"
      , "name": "Gladiator"
      , "uniqueName": "gladiator"
      }
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/gladiator/F8pWu44tbhbJmb/ "
        }
      ]
    }
  , { "@type": "clip"
    , "code": "F8pW2nuuhu7J"
    , "duration": "58200"
    , "name": "motivational speech"
    , "thumbnail": "http://thumbs.anyclip.com/tGyjzRLzw/tmb_380_480.jpg"
    , "timeIn": "375500"
    , "timeOut": "433700"
    , "title":
      { "code": "tGyjzRLzw"
      , "name": "Gladiator"
      , "uniqueName": "gladiator"
      }
    , "uniqueName": "motivational-speech"
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/gladiator/motivational-speech/ "
        }
      ]
    }
  , { "@type": "clip"
    , "code": "oQSs2nY47hbJmm"
    , "duration": "120000"
    , "name": "the skateboard"
    , "thumbnail": "http://thumbs.anyclip.com/tFZoB7Igx/tmb_3800_480.jpg"
    , "timeIn": "3794800"
    , "timeOut": "3914800"
    , "title":
      { "code": "tFZoB7Igx"
      , "name": "Back to the Future"
      , "uniqueName": "back-to-the-future"
      }
    , "uniqueName": "the-skateboard"
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/back-to-the-future/the-skateboard/ "
        }
      ]
    }
  , { "@type": "clip"
    , "code": "oQSsutYJthbJmb"
    , "duration": "120100"
    , "thumbnail": "http://thumbs.anyclip.com/tFZoB7Igx/tmb_5700_480.jpg"
    , "timeIn": "5692600"
    , "timeOut": "5812700"
    , "title":
      { "code": "tFZoB7Igx"
      , "name": "Back to the Future"
      , "uniqueName": "back-to-the-future"
      }
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/back-to-the-future/oQSsutYJthbJmb/ "
        }
      ]
    }
  , { "@type": "clip"
    , "code": "oQSsutYJthbJmb"
    , "duration": "120100"
    , "thumbnail": "http://thumbs.anyclip.com/tFZoB7Igx/tmb_5700_480.jpg"
    , "timeIn": "5692600"
    , "timeOut": "5812700"
    , "title":
      { "code": "tFZoB7Igx"
      , "name": "Back to the Future"
      , "uniqueName": "back-to-the-future"
      }
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/back-to-the-future/oQSsutYJthbJmb/ "
        }
      ]
    }
  ]
, "totalItemsCount": "5"
}

Clips tf=4 (plot), maxResult=1

http://apis.anyclip.com/api/clips/popular/?cid=[cid]&format=JSON&maxResults=1&sig=[sig]&tf=4

{ "result":
  [ { "@type": "clip"
    , "code": "F8pWu44tbhbJmb"
    , "duration": "120100"
    , "thumbnail": "http://thumbs.anyclip.com/tGyjzRLzw/tmb_5450_480.jpg"
    , "timeIn": "5446100"
    , "timeOut": "5566200"
    , "title":
      { "code": "tGyjzRLzw"
      , "name": "Gladiator"
      , "plots":
        { "source": "http://www.imdb.com/title/tt0172495/plotsummary"
        , "text": "When a Roman general is betrayed and his family murdered by a corrupt prince, he comes to Rome as a gladiator to seek revenge."
        , "type": "IMDB"
        }

      , "uniqueName": "gladiator"
      }

    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/gladiator/F8pWu44tbhbJmb/ "
        }

      ]

    }

  ]

, "totalItemsCount": "1"
}


getAlphabetic

Returns multiple clips, titles actors or directors with name, or last name for actors and directors, starting with letter specified

Use startIndex and maxResults for pagination, otherwise total items count is limited to no more than 5.

Path

Parameters

Type

Item

Notes

/actors/alphabetic/[starstWith]/

starstWith

string

required

The letter actors last names start with.

filter

similar to /actor/ method

/directors/alphabetic/[startsWith]/

id

string

required

The letter directors last names start with.

filter

similar to /director/ method

/titles/alphabetic/[startsWith]/

id

string

required

The letter movie names start with.

filter

similar to /title/ method

/actors/emptyletters/

filter

similar to /actor/ method

Actors with last name starting with character not from English ABC.

/directors/emptyletters/

filter

similar to /director/ method

Directors with last name starting with character not from English ABC.

/titles/emptyletters/

filter

similar to /title/ method

Movies with name starting with character not from English ABC.


getNearest

Returns clips near the location - clips that were filmed or its scenario happens at the distance less then miles parameter value from coordinates specified with (longitudelatitude) parameters
The method is precisious only with small distances
tf=title filter
af=actors filter
df=directors filter

Path

Parameters

Type

Item

Notes

 /clips/near/

 longitude  float  longitude coordinate    
 latitude  float  latitude coordinate     
 miles  int  distance    maximal distance from (langitude,latitude) point in miles

filter

Similar to /clip/ method

tf

Similar to 'filter' parameter in /title/ method. Used when movies the clips belong to are returned.

af

Similar to 'filter' parameter in  /actor/ method. Used when actors participating in the clips are returned.

df

Similar to 'filter' parameter in  /director/ method. Used when directors of the movies are returned.


Example 

http://apis.anyclip.com/api/clips/near?cid=[cid]&format=JSON&latitude=0&longitude=0&miles=10000&sig=[sig]

{     "totalItemsCount":"0",     "result":[{         "code":"dd_fJmtmuh2mn",         "duration":"30700",         "name":"A Difficult Decision",         "thumbnail":"http://thumbs.anyclip.com/tssCO8pSo/tmb_2103_480.jpg",         "timeIn":"2060500",         "timeOut":"2091200",         "title":{             "code":"tssCO8pSo",             "duration":"5610900",             "franchiseId":"-1",             "imdbId":"460766",             "name":"Deep Water",             "releaseDate":"1136073600000",             "studioId":"98",             "uniqueName":"deep-water"},         "urls":[{             "type":"Regular",             "url":"http://www.anyclip.com/movies/deep-water/dd_fJmtmuh2mn/"}]},     {         "code":"dd_fJbJ7nh7uu",         "duration":"85500",         "name":"A Difficult Decision Part 2",         "thumbnail":"http://thumbs.anyclip.com/tssCO8pSo/tmb_2130_480.jpg",         "timeIn":"2128700",         "timeOut":"2214200",         "title":{             "code":"tssCO8pSo",             "duration":"5610900",             "franchiseId":"-1",             "imdbId":"460766",             "name":"Deep Water",             "releaseDate":"1136073600000",             "studioId":"98",             "uniqueName":"deep-water"},         "urls":[{             "type":"Regular",             "url":"http://www.anyclip.com/movies/deep-water/dd_fJbJ7nh7uu/"}]},     {         "code":"dd_fJ4nu4htJY",         "duration":"62900",         "name":"The Third Option Part 3",         "thumbnail":"http://thumbs.anyclip.com/tssCO8pSo/tmb_2480_480.jpg",         "timeIn":"2475400",         "timeOut":"2538300",         "title":{             "code":"tssCO8pSo",             "duration":"5610900",             "franchiseId":"-1",             "imdbId":"460766",             "name":"Deep Water",             "releaseDate":"1136073600000",             "studioId":"98",             "uniqueName":"deep-water"},         "urls":[{             "type":"Regular",             "url":"http://www.anyclip.com/movies/deep-water/dd_fJ4nu4htJY/"}]},     {         "code":"yC71uu2mhJn7",         "duration":"27800",         "name":"eating dinner",         "thumbnail":"http://thumbs.anyclip.com/tRP8al2Dp/tmb_560_480.jpg",         "timeIn":"553000",         "timeOut":"580800",         "title":{             "code":"tRP8al2Dp",             "duration":"7549630",             "franchiseId":"-1",             "imdbId":"318462",             "name":"Diarios de motocicleta",             "releaseDate":"1072915200000",             "studioId":"4",             "uniqueName":"diarios-de-motocicleta"},         "urls":[{             "type":"Regular",             "url":"http://www.anyclip.com/movies/diarios-de-motocicleta/yC71uu2mhJn7/"}]},         {         "code":"yC7127nnhb4m",         "duration":"14000",         "name":"begining the trip",         "thumbnail":"http://thumbs.anyclip.com/tRP8al2Dp/tmb_390_480.jpg",         "timeIn":"387700",         "timeOut":"401700",         "title":{             "code":"tRP8al2Dp",             "duration":"7549630",             "franchiseId":"-1",             "imdbId":"318462",             "name":"Diarios de motocicleta",             "releaseDate":"1072915200000",             "studioId":"4",             "uniqueName":"diarios-de-motocicleta"},         "urls":[{             "type":"Regular",             "url":"http://www.anyclip.com/movies/diarios-de-motocicleta/yC7127nnhb4m/"}]}]} 

getByTitlesYears

Returns movies released between years specified by startYear and endYear parameters
af=actors filter
df=directors filter 
cf=clips filter

Path

Parameter

Type

Item

Notes

/titles/year/[startYear]/[endYear]/

Path param  startYear

 int

 Year in four digit format. E.g. 1948.

 Earliest release year of movies returned.

Path param endYear

 int

 Year in four digit format. E.g. 1948.

 Latest release year of movies returned.

filter

Similar to 'filter' parameter in /title/ method.

af

Similar to 'filter' parameter in  /actor/ method. Used when actors participating in the movies are returned.

df

Similar to 'filter' parameter in  /director/ method. Used when directors of the movies are returned.

cf

Similar to 'filter' parameter in  /clip/ method. Used when some clips from the movies are returned.



getRecentTitles

Returns movies recently added to the AnyCLip databases.
af=actors filter
df=directors filter 
cf=clips filter

Path

Parameter

Notes

/titles/recent/

filter

Similar to 'filter' parameter in /title/ method.

af

Similar to 'filter' parameter in  /actor/ method. Used when actors participating in the movies are returned.

df

Similar to 'filter' parameter in  /director/ method. Used when directors of the movies are returned.

cf

Similar to 'filter' parameter in  /clip/ method. Used when some clips from the movies are returned.


Example

/titles/recent/
no filters

http://apis.anyclip.com/api/titles/recent/?cid=[cid]&format=JSON&sig=[sig]

{ "result":
  [ { "@type": "title"
    , "code": "t0SmcIP9I"
    , "name": "Private School"
    , "poster": "http://img.anyclip.com/posters/t0SmcIP9I_200.jpg"
    , "uniqueName": "private-school"
    , "url": "http://anyclip.com/movies/private-school/"
    }
  , { "@type": "title"
    , "code": "thBwEaSxH"
    , "name": "Sleepers"
    , "poster": "http://img.anyclip.com/posters/thBwEaSxH_200.jpg"
    , "uniqueName": "sleepers"
    , "url": "http://anyclip.com/movies/sleepers/"
    }
  , { "@type": "title"
    , "code": "tOeKslZuF"
    , "name": "Mo' Better Blues"
    , "poster": "http://img.anyclip.com/posters/tOeKslZuF_200.jpg"
    , "uniqueName": "mo-better-blues"
    , "url": "http://anyclip.com/movies/mo-better-blues/"
    }
  , { "@type": "title"
    , "code": "t2ND8fOvq"
    , "name": "Nurse Betty"
    , "poster": "http://img.anyclip.com/posters/t2ND8fOvq_200.jpg"
    , "uniqueName": "nurse-betty"
    , "url": "http://anyclip.com/movies/nurse-betty/"
    }
  , { "@type": "title"
    , "code": "tStvu4UId"
    , "name": "Janghwa, Hongryeon"
    , "poster": "http://img.anyclip.com/posters/tStvu4UId_200.jpg"
    , "uniqueName": "janghwa-hongryeon"
    , "url": "http://anyclip.com/movies/janghwa-hongryeon/"
    }
  ]
, "totalItemsCount": "10"
}


getNewTitles

Returns newest movies: coming soon, now in theaters, new at DVD. 
Parameters of each method are similar to /titles/recent/ method.

filter=movies properties filter
af=actors filter
df=directors filter 
cf=clips filter

Path

Parameters

Item

Notes

/titles/coming/

filter, af, df, cf

Parameters are similar to /titles/recent/ method.

Movies that will be released in future.

/titles/in_theaters/

filter, af, df, cf

Parameters are similar to /titles/recent/ method.

Movies that were already released and still can be found in theaters.

/titles/new_dvd/

filter, af, df, cf

Parameters are similar to /titles/recent/ method.

Movies that were released at DVD in last 14 days.



getRelated

Don't use startIndex parameter with related methods. Since calculation of related involves client view quota and country restriction, behaivour of this parameters is undefined.

rf=related clips filter

Path

Parameter

Type

Bitwise Value

Item

Notes

/clip/[id]/related/

id

string

 

 

id= clip code or unique name

titleId

string


movie code

id= movie code or unique name

userID

string

 

 player id

Use userID with custom player if you want to filter results by country or view quota restrictions. 

userID = unique identifier of the flash player instance

rf

Similar to 'filter' parameter in /clip/ method.

/titles/[id]/related

id

string

 

 

id code

filter

Similar to 'filter' parameter in /title/ method.


Examples

get Related Clips

http://apis.anyclip.com/api/clip/F8pW2nuuhu7J/related?cid=[cid]&format=JSON&sig=[sig]

clip=F8pW2nuuhu7J (motivational speech clip from the Gladiator)
no filters

{ "result":
  [ { "@type": "clip"
    , "code": "kG2Rbm2umhbm4m"
    , "duration": "104000"
    , "name": "mental breakdown "
    , "thumbnail": "http://thumbs.anyclip.com/trw3QhC4n/tmb_1040_480.jpg"
    , "timeIn": "1035000"
    , "timeOut": "1139000"
    , "title":
      { "actors":
        [ { "code": "pekxrR78V"
          , "name": "Russell Crowe"
          , "uniqueName": "russell-crowe"
          , "url": "http://anyclip.com/actors/russell-crowe/"
          }
        , { "code": "piYg6d4oj"
          , "name": "Ed Harris"
          , "uniqueName": "ed-harris"
          , "url": "http://anyclip.com/actors/ed-harris/"
          }
        , { "code": "plrcT3dVc"
          , "name": "Jennifer Connelly"
          , "uniqueName": "jennifer-connelly"
          , "url": "http://anyclip.com/actors/jennifer-connelly/"
          }
        , { "code": "pN6x8qhFC"
          , "name": "Christopher Plummer"
          , "uniqueName": "christopher-plummer"
          , "url": "http://anyclip.com/actors/christopher-plummer/"
          }
        , { "code": "pmI3J0rnF"
          , "name": "Paul Bettany"
          , "uniqueName": "paul-bettany"
          , "url": "http://anyclip.com/actors/paul-bettany/"
          }
        ]
      , "code": "trw3QhC4n"
      , "directors":
        [ { "code": "pIFaqJJQ9"
          , "name": "Ron Howard"
          , "uniqueName": "ron-howard"
          , "url": "http://anyclip.com/directors/ron-howard/"
          }
        ]
      , "name": "A Beautiful Mind"
      , "poster": "http://img.anyclip.com/posters/trw3QhC4n_200.jpg"
      , "uniqueName": "a-beautiful-mind"
      , "url": "http://anyclip.com/movies/a-beautiful-mind/"
      }
    , "uniqueName": "mental-breakdown-"
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/a-beautiful-mind/mental-breakdown-/ "
        }
      ]
    }
  , { "@type": "clip"
    , "code": "bKn47222uhbbn"
    , "duration": "11700"
    , "name": "About Frank Lucas"
    , "thumbnail": "http://thumbs.anyclip.com/t1v74PJjA/tmb_8340_480.jpg"
    , "timeIn": "8333500"
    , "timeOut": "8345200"
    , "title":
      { "actors":
        [ { "code": "piM2yCol5"
          , "name": "Denzel Washington"
          , "uniqueName": "denzel-washington"
          , "url": "http://anyclip.com/actors/denzel-washington/"
          }
        , { "code": "pyV3xkQqy"
          , "name": "Chiwetel Ejiofor"
          , "uniqueName": "chiwetel-ejiofor"
          , "url": "http://anyclip.com/actors/chiwetel-ejiofor/"
          }
        , { "code": "pNj2XIi0G"
          , "name": "Josh Brolin"
          , "uniqueName": "josh-brolin"
          , "url": "http://anyclip.com/actors/josh-brolin/"
          }
        , { "code": "phvTuJ33W"
          , "name": "Lymari Nadal"
          , "uniqueName": "lymari-nadal"
          , "url": "http://anyclip.com/actors/lymari-nadal/"
          }
        , { "code": "pElTRZMF7"
          , "name": "Ruby Dee"
          , "uniqueName": "ruby-dee"
          , "url": "http://anyclip.com/actors/ruby-dee/"
          }
        ]
      , "code": "t1v74PJjA"
      , "directors":
        [ { "code": "pGT3AbNwL"
          , "name": "Ridley Scott"
          , "uniqueName": "ridley-scott"
          , "url": "http://anyclip.com/directors/ridley-scott/"
          }
        ]
      , "name": "American Gangster"
      , "poster": "http://img.anyclip.com/posters/t1v74PJjA_200.jpg"
      , "uniqueName": "american-gangster"
      , "url": "http://anyclip.com/movies/american-gangster/"
      }
    , "uniqueName": "about-frank-lucas"
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/american-gangster/about-frank-lucas/ "
        }
      ]
    }
  , { "@type": "clip"
    , "code": "KTEnJY4b7hbbbJ"
    , "duration": "111200"
    , "name": "preparing for the fight"
    , "thumbnail": "http://thumbs.anyclip.com/tveV7J0Ha/tmb_2950_480.jpg"
    , "timeIn": "2941800"
    , "timeOut": "3053000"
    , "title":
      { "actors":
        [ { "code": "pekxrR78V"
          , "name": "Russell Crowe"
          , "uniqueName": "russell-crowe"
          , "url": "http://anyclip.com/actors/russell-crowe/"
          }
        , { "code": "pmQIw3KNQ"
          , "name": "Renée Zellweger"
          , "uniqueName": "renee-zellweger"
          , "url": "http://anyclip.com/actors/renee-zellweger/"
          }
        , { "code": "pDRLzOrP1"
          , "name": "Paul Giamatti"
          , "uniqueName": "paul-giamatti"
          , "url": "http://anyclip.com/actors/paul-giamatti/"
          }
        , { "code": "pyp4Bd3bF"
          , "name": "Craig Bierko"
          , "uniqueName": "craig-bierko"
          , "url": "http://anyclip.com/actors/craig-bierko/"
          }
        , { "code": "pj6VcgwVO"
          , "name": "Paddy Considine"
          , "uniqueName": "paddy-considine"
          , "url": "http://anyclip.com/actors/paddy-considine/"
          }
        ]
      , "code": "tveV7J0Ha"
      , "directors":
        [ { "code": "pIFaqJJQ9"
          , "name": "Ron Howard"
          , "uniqueName": "ron-howard"
          , "url": "http://anyclip.com/directors/ron-howard/"
          }
        ]
      , "name": "Cinderella Man"
      , "poster": "http://img.anyclip.com/posters/tveV7J0Ha_200.jpg"
      , "uniqueName": "cinderella-man"
      , "url": "http://anyclip.com/movies/cinderella-man/"
      }
    , "uniqueName": "preparing-for-the-fight"
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/cinderella-man/preparing-for-the-fight/ "
        }
      ]
    }
  , { "@type": "clip"
    , "code": "sLqX7bmtuhbJmm"
    , "duration": "120000"
    , "name": "The Fight Begins"
    , "thumbnail": "http://thumbs.anyclip.com/tBkifwcXl/tmb_8110_480.jpg"
    , "timeIn": "8106500"
    , "timeOut": "8226500"
    , "title":
      { "actors":
        [ { "code": "pekxrR78V"
          , "name": "Russell Crowe"
          , "uniqueName": "russell-crowe"
          , "url": "http://anyclip.com/actors/russell-crowe/"
          }
        , { "code": "p6BOhOfPH"
          , "name": "Cate Blanchett"
          , "uniqueName": "cate-blanchett"
          , "url": "http://anyclip.com/actors/cate-blanchett/"
          }
        , { "code": "pAMUX2KvM"
          , "name": "Max von Sydow"
          , "uniqueName": "max-von-sydow"
          , "url": "http://anyclip.com/actors/max-von-sydow/"
          }
        , { "code": "pcS3auexL"
          , "name": "William Hurt"
          , "uniqueName": "william-hurt"
          , "url": "http://anyclip.com/actors/william-hurt/"
          }
        , { "code": "pXKIQW963"
          , "name": "Mark Strong"
          , "uniqueName": "mark-strong"
          , "url": "http://anyclip.com/actors/mark-strong/"
          }
        ]
      , "code": "tBkifwcXl"
      , "directors":
        [ { "code": "pGT3AbNwL"
          , "name": "Ridley Scott"
          , "uniqueName": "ridley-scott"
          , "url": "http://anyclip.com/directors/ridley-scott/"
          }
        ]
      , "name": "Robin Hood"
      , "poster": "http://img.anyclip.com/posters/tBkifwcXl_200.jpg"
      , "uniqueName": "robin-hood-2010"
      , "url": "http://anyclip.com/movies/robin-hood-2010/"
      }
    , "uniqueName": "the-fight-begins"
    , "urls":
      [ { "type": "Regular"
        , "url": "http://anyclip.com/movies/robin-hood-2010/the-fight-begins/ "
        }
      ]
    }
  ]
, "totalItemsCount": "4"
}

get Related Titles

title id=tGyjzRLzw/ (Gladiator)
no filters

http://apis.anyclip.com/api/title/tGyjzRLzw/related/?cid=[cid]&format=JSON&sig=[sig]

{ "result":
  [ { "@type": "title"
    , "code": "tPu6jbMAB"
    , "name": "Spartacus"
    , "poster": "http://img.anyclip.com/posters/tPu6jbMAB_200.jpg"
    , "uniqueName": "spartacus"
    , "url": "http://anyclip.com/movies/spartacus/"
    }
  , { "@type": "title"
    , "code": "tSf4jZdFC"
    , "name": "Great Escape, The"
    , "poster": "http://img.anyclip.com/posters/tSf4jZdFC_200.jpg"
    , "uniqueName": "the-great-escape"
    , "url": "http://anyclip.com/movies/the-great-escape/"
    }
  , { "@type": "title"
    , "code": "t1auRcJRP"
    , "name": "Alexander"
    , "poster": "http://img.anyclip.com/posters/t1auRcJRP_200.jpg"
    , "uniqueName": "alexander"
    , "url": "http://anyclip.com/movies/alexander/"
    }
  , { "@type": "title"
    , "code": "t6DTIkzOV"
    , "name": "Ben-Hur"
    , "poster": "http://img.anyclip.com/posters/t6DTIkzOV_200.jpg"
    , "uniqueName": "ben-hur"
    , "url": "http://anyclip.com/movies/ben-hur/"
    }
  , { "@type": "title"
    , "code": "t1BMnKgsc"
    , "name": "Apollo 13"
    , "poster": "http://img.anyclip.com/posters/t1BMnKgsc_200.jpg"
    , "uniqueName": "apollo-13"
    , "url": "http://anyclip.com/movies/apollo-13/"
    }
  ]
, "totalItemsCount": "10"
}



getShortUrl

path: /clip/[id]/short_url
where [id] is a string id code of the clip.
Returns a shortcut URL of the clip.

Example

http://apis.anyclip.com/api/clip/JLWx742mhnnm/short_url/?cid=[cid]&format=JSON&sig=[sig]

clip id=JLWx742mhnnmr (analyzing-the-murder)


{ "type": "Short"
, "url": "http://clip.ly/gS5r7k"
}

Short_url is a shortcut  http://clip.ly/gS5r7k for this longer url "http://www.anyclip.com/movies/m/analyzing-the-murderer/".


The same data ca be retrieved using clip filter containing SHORT_URL (512) , for example:

http://apis.anyclip.com/api/clip/JLWx742mhnnm/?cid=[cid]&filter=512&[format=[JSON|xml]]&sig=[sig]

{ "code": "JLWx742mhnnm"
, "duration": "77000"
, "name": "Analyzing the murderer"
, "timeIn": "843000"
, "timeOut": "920000"
, "title":
  { "code": "t2kzSXv35"
  , "name": "M"
  , "uniqueName": "m"
  }

, "uniqueName": "analyzing-the-murderer"
, "urls":
  [ { "type": "Short"
    , "url": "http://clip.ly/gS5r7k"
    }

  ]

}


Genres and Franchises

The /genres/list/ and the /franchises/list/ returns list of all genres or franchises.

Search

The search method allows you to search within the actor, director, or title entities by code (but not by unique name).

In addition to required q filter, efilter, af, cf, df, and tf filters may be applied to define properties of entities that should be returned. The sid and the fid parameters filter results by studio and franchise.

Entity

Search Returns

Optional Filters

/actor/[id]/search/

titles, clips

efilter, tf, af, cf, df, sid, fid

/director/[id]/search/

titles, clips

efilter, tf, af,cf, df, sid, fid

/title/[id]/search/

actors, directors, clips

efilter, tf, af, cf, df, sid, fid


See Search Reference for the possible parameter values for each of the filters.

Examples

Actor, efilter=4 (title)

actor=pxHP2FIR3 (Tom Hanks)
q=apollo
efilter=4 (title)

http://apis.anyclip.com/api/actor/pxHP2FIR3/search/?cid=[cid]&efilter=4&format=JSON&q=apollo&sig=[sig]

{ "timeElapsedMs": "4"
, "titles":
  [ { "result":
      [ { "@type": "title"
        , "code": "t1BMnKgsc"
        , "name": "Apollo 13"
        , "uniqueName": "apollo-13"
        }
      ]
    , "totalItemsCount": "1"
    }
  ]
}

Actor, no filters

actor=pxHP2FIR3 (Tom Hanks)
q=big
Return clips in which Tom Hanks appears with "big" in the dialog

http://apis.anyclip.com/api/actor/pxHP2FIR3/search/?cid=[cid]&format=JSON&q=big&sig=[sig]

{ "clips":
  { "result":
    [ { "@type": "clip"
      , "code": "bscB77nh2mb"
      , "duration": "30000"
      , "timeIn": "88735"
      , "timeOut": "118735"
      , "title":
        { "code": "t1BMnKgsc"
        , "name": "Apollo 13"
        , "poster": "http://img.anyclip.com/posters/t1BMnKgsc_200.jpg"
        , "uniqueName": "apollo-13"
        }
      }
    , { "@type": "clip"
      , "code": "bscBt422bh2mb"
      , "duration": "30000"
      , "timeIn": "6433146"
      , "timeOut": "6463146"
      , "title":
        { "code": "t1BMnKgsc"
        , "name": "Apollo 13"
        , "poster": "http://img.anyclip.com/posters/t1BMnKgsc_200.jpg"
        , "uniqueName": "apollo-13"
        }
      }
    , { "@type": "clip"
      , "code": "bscBt22nuh2mb"
      , "duration": "30000"
      , "timeIn": "6337592"
      , "timeOut": "6367592"
      , "title":
        { "code": "t1BMnKgsc"
        , "name": "Apollo 13"
        , "poster": "http://img.anyclip.com/posters/t1BMnKgsc_200.jpg"
        , "uniqueName": "apollo-13"
        }
      }
    , { "@type": "clip"
      , "code": "bscBt2muJh2mb"
      , "duration": "30000"
      , "timeIn": "6305267"
      , "timeOut": "6335267"
      , "title":
        { "code": "t1BMnKgsc"
        , "name": "Apollo 13"
        , "poster": "http://img.anyclip.com/posters/t1BMnKgsc_200.jpg"
        , "uniqueName": "apollo-13"
        }
      }
    , { "@type": "clip"
      , "code": "eMEYnntJnh2mb"
      , "duration": "30000"
      , "timeIn": "7762783"
      , "timeOut": "7792783"
      , "title":
        { "code": "tlqV9gEnY"
        , "name": "Green Mile, The"
        , "poster": "http://img.anyclip.com/posters/tlqV9gEnY_200.jpg"
        , "uniqueName": "the-green-mile"
        }
      }
    ]
  , "totalItemsCount": "8"
  }
, "timeElapsedMs": "10"
}

 
 
Subpages (1): getItem
Comments