Go back to Partigi API Documentation

items/index

Returns a list of items obtained from the given conditions.

URL:

http://www.partigi.com/api/v1/items/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, serie, book,... (see item types page), and optionally one or more of the following (in 'yyyy-mm-dd' format):
• release_date_es: Filter by the release date in Spain.
• from_release_date_es: Filter by the release date in Spain, returning only items which release date is greater that this value.
• upto_release_date_es: Filter by the release date in Spain, returning only items which release date is minor than the given value.
• release_date_us: Filter by the release date in USA.
• from_release_date_us: Filter by the release date in USA, returning only items which release date is greater that this value.
• upto_release_date_us: Filter by the release date in USA, returning only items which release date is minor than the given value.

   and/or

• q: A term to filter by. This filter is applied on text fields (title, cast members, and so on).

Optional: 

• locale: Locale in which return the information (see available locales page).

• per_page: The number of results per page to retrieve, from 1 up to 100. By default retrieves 10 elements.
• page: The page from which retrieve the results. By default is 1.

Examples:

• http://www.partigi.com/api/v1/items/index.xml?q=Bill+Murray&item_type=film&limit=5

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