searchproducts

REST Endpoint: http://api.itunesapis.com/rest/searchproducts/

Overview

Search for a product by a search term. Optionally specify an entity type (music, audiobook, etc..) and a limit of how many results to receive. Search defaults to iPhone apps as the entity type.

/searchproducts/?

Parameter Required? Description
a Y Your API key.
term Y A keyword or phrase to search for
entity N iTunes Entity Type. Defaults to Software. Get List by calling getEntityTypes
includeExplicit N Indicates whether to include explicit, or return only explicit. Valid values are Y=yes, N=no, O=Explicit Only. Defaults to Y for include explicits in results.

Sample Call

http://api.itunesapis.com/rest/searchproducts/?a=YOURAPIKEY &term=icopter

Result

                        
    
<result>
    <product>
        <product-id>354763230</product-id>
        <product-name>Asteroid Runner</product-name>
        <product-type>software</product-type>
        <release-date>2010-02-13T01:54:38Z</release-date>
        <description></description>
        <seller>Millennium Studios, LLC</seller>
        <seller-id>347888145</seller-id>
        <seller-page-url/>
        <product-web-url/>
        <price-source-currency>0.99</price-source-currency>
        <price-source-currencycode/>
        <price>0.99</price>
        <currency-code/>
        <iconurl>
            http://a1.phobos.apple.com/us/r1000/042/Purple/61/3d/19/mzl.upgapsxd.png
        </iconurl>
        <icon-largeurl/>
        <itunestoreurl>
            http://itunesclick.itunesapis.com/deeplink?id=JP3KbstZd5U&mid=13508&murl=&u1=10500
        </itunestoreurl>
        <primary-category>Games</primary-category>
        <primary-categoryid>6014</primary-categoryid>
        <categories>
            <category>
                <category-id>6014</category-id>
                <category-name>Games</category-name>
            </category>
            <category>
                <category-id>7001</category-id>
                <category-name>Action</category-name>
            </category>
            <category>
                <category-id>7003</category-id>
                <category-name>Arcade</category-name>
            </category>
        </categories>
        <rating-overall>2</rating-overall>
        <rating-current-version>2</rating-current-version>
        <ratings-all-versions>
            <rating>
                <stars>5</stars>
                <count>38</count>
            </rating>
            <rating>
                <stars>4</stars>
                <count>17</count>
            </rating>
            <rating>
                <stars>3</stars>
                <count>28</count>
            </rating>
            <rating>
                <stars>2</stars>
                <count>60</count>
            </rating>
            <rating>
                <stars>1</stars>
                <count>199</count>
            </rating>
        </ratings-all-versions>
        <ratings-current-version>
            <rating>
                <stars>5</stars>
                <count>23</count>
                </rating>
            <rating>
                <stars>4</stars>
                <count>14</count>
            </rating>
            <rating>
                <stars>3</stars>
                <count>18</count>
            </rating>
            <rating>
                <stars>2</stars>
                <count>49</count>
            </rating>
            <rating>
                <stars>1</stars>
                <count>125</count>
            </rating>
        </ratings-current-version>
        <filesize>6238176</filesize>
        <country/>
        <language/>
        <version>1.0.1</version>
        <screenshots>
            <screenshot>
            http://a1.phobos.apple.com/us/r1000/012/Purple/ce/83/2e/mzl.tbncwjdu.jpg
            </screenshot>
            <screenshot>
            http://a1.phobos.apple.com/us/r1000/044/Purple/65/fe/05/mzl.enazjojf.jpg
            </screenshot>
            <screenshot>
            http://a1.phobos.apple.com/us/r1000/028/Purple/55/b1/9c/mzl.unlvctup.jpg
            </screenshot>
            <screenshot>
            http://a1.phobos.apple.com/us/r1000/007/Purple/a7/d4/af/mzl.oqmlfczb.jpg
            </screenshot>
        </screenshots>
    </product>
    <product>
        ....
        ....
        Product 2 details
        ....
    </product>                                        
</result>

Errors

All errors are reported in the following format with a description of the error.

<result>
    <error>
        ERROR MESSAGE HERE
    </error>>
</result>