Go back to Partigi API Documentation

releases/index

Returns a list of films (at the moment, is the only type of film allowed) that are relased in the range of dates specified in the parameters. If no parameter is given, the current week is assumed to be the range. Also, you can indicate the location of the releases. At the moment, only 'es' or 'us' are the allowed locations.

URL:

http://www.partigi.com/api/v1/releases/index.format

Formats:

atom, json (more about JSON responses)

HTTP Methods:

GET

Authentication Mode:

read-only

Parameters:

Required:

• item_type: The type of the item: film (only film at this moment), and optionally one or more of the following (in 'yyyy-mm-dd' format):
• start_date: the beginning of the range 
• end_date: the end of the range. The difference between this date and the start_date parameter has to be less o equal than 7 days

Optional: 

• location: Location of the search. 

Examples:

• http://www.partigi.com/api/v1/releases/index.xml?item_type=film

Response:

  <?xml version="1.0" encoding="UTF-8"?>
  <feed xmlns="http://www.w3.org/2005/Atom">
    <title>Films &#187; Partigi</title>
    <id>http://www.partigi.com/api/v1/films.atom?locale=en&amp;amp;page=100&amp;amp;per_page=10&amp;amp;type=film</id>
    <updated>2009-06-08T09:03:20Z</updated>
    <link type="application/atom+xml" href="http://www.partigi.com/api/v1/films.atom?locale=en&amp;amp;page=100&amp;amp;per_page=10&amp;amp;item_type=film" rel="self"/>
    <link type="text/html" href="http://www.partigi.com/api/v1/films.html?locale=en&amp;amp;page=100&amp;amp;per_page=10&amp;amp;item_type=film" rel="alternate"/>
    <author>
      <name>Partigi</name>
    </author>
 
    <entry xmlns:ptPerson="http://schemas.partigi.com/v1.0/ptPerson" xmlns:ptItem="http://schemas.partigi.com/v1.0/ptItem">
      <category scheme="http://schemas.partigi.com/v1.0#kind" term="http://schemas.partigi.com/v1.0#item"/>
      <id>http://www.partigi.com/films/mary-poppins</id>
      <title>Mary Poppins</title>
      <updated>2009-06-08T09:03:20Z</updated>
      <published>2009-04-28T12:30:03Z</published>
      <link type="text/html" rel="alternate" href="http://www.partigi.com/films/mary-poppins"/>
      <link type="application/atom+xml" rel="self" href="http://www.partigi.com/api/v1/films/mary-poppins.atom"/>
      <ptItem:id>665</ptItem:id>
      <ptItem:item_type>film</ptItem:item_type>
      <ptItem:year>1965</ptItem:year>
      <ptItem:title lang="en">Mary Poppins</ptItem:title>
      <ptItem:country>USA</ptItem:country>
      <ptItem:posters type="collection">
        <ptItem:poster type="image/jpeg" lang="en" size="thumb" href="http://s3.amazonaws.com/partigidev/films/posters/1407/mary-poppins_thumb.jpg"/>
      </ptItem:posters>
      <ptItem:credits type="collection">
        <ptPerson:entry rel="director">
          <ptPerson:id>7371</ptPerson:id>
          <ptPerson:name>Robert Stevenson</ptPerson:name>
        </ptPerson:entry>
        <ptPerson:entry rel="cast_member">
          <ptPerson:id>6588</ptPerson:id>
          <ptPerson:name>Julie Andrews</ptPerson:name>
        </ptPerson:entry>
        <ptPerson:entry rel="cast_member">
          <ptPerson:id>7372</ptPerson:id>
          <ptPerson:name>Dick Van Dyke</ptPerson:name>
        </ptPerson:entry>
      </ptItem:credits>
    </entry>
  
    <entry xmlns:ptPerson="http://schemas.partigi.com/v1.0/ptPerson" xmlns:ptItem="http://schemas.partigi.com/v1.0/ptItem">
      <category scheme="http://schemas.partigi.com/v1.0#kind" term="http://schemas.partigi.com/v1.0#item"/>
      <id>http://www.partigi.com/films/2001-space-odyssey</id>
      <title>2001: A Space Odyssey</title>
      <updated>2009-06-08T09:01:57Z</updated>
      <published>2009-04-03T10:26:56Z</published>
      <link type="text/html" rel="alternate" href="http://www.partigi.com/films/2001-space-odyssey"/>
      <link type="application/atom+xml" rel="self" href="http://www.partigi.com/api/v1/films/2001-space-odyssey.atom"/>
      <ptItem:id>152</ptItem:id>
      <ptItem:item_type>film</ptItem:item_type>
      <ptItem:year>1968</ptItem:year>
      <ptItem:title lang="en">2001: A Space Odyssey</ptItem:title>
      <ptItem:country>UK</ptItem:country>
      <ptItem:country>USA</ptItem:country>
      <ptItem:posters type="collection">
        <ptItem:poster type="image/jpeg" lang="" size="thumb" href="http://s3.amazonaws.com/partigidev/films/posters/459/2001-space-odyssey_thumb.jpg"/>
      </ptItem:posters>
      <ptItem:credits type="collection">
        <ptPerson:entry rel="director">
          <ptPerson:id>1234</ptPerson:id>
          <ptPerson:name>Stanley Kubrick</ptPerson:name>
        </ptPerson:entry>
        <ptPerson:entry rel="writer">
          <ptPerson:id>1234</ptPerson:id>
          <ptPerson:name>Stanley Kubrick</ptPerson:name>
        </ptPerson:entry>
        <ptPerson:entry rel="cast_member">
          <ptPerson:id>1948</ptPerson:id>
          <ptPerson:name>Keir Dullea</ptPerson:name>
        </ptPerson:entry>
        <ptPerson:entry rel="cast_member">
          <ptPerson:id>1949</ptPerson:id>
          <ptPerson:name>Gary Lockwood</ptPerson:name>
        </ptPerson:entry>
      </ptItem:credits>
    </entry>
  </feed>

Go back to Partigi API Documentation