36.3. Zend_Service_Amazon

Zend_Service_Amazon_Query provides an alternative API for using the Amazon Web Service. The alternative API uses the Fluent Interface pattern. That is, all calls can be made using chained method calls. (e.g., $obj->method()->method2($arg))

The Zend_Service_Amazon_Query API uses overloading to easily set up an item search and then allows you to search based upon the criteria specified. Each of the options is provided as a method call, and each method's argument corresponds to the named option's value:

$query = new Zend_Service_Amazon_Query('MY_API_KEY');
$query->Category('Books')->Keywords('PHP');
$results = $query->search();
foreach ($results as $result) {
    echo $result->Title . '<br />';
}

Zend_Service_Amazon_Item is the class type used to represent an Amazon item returned by the web service. It encompasses all of the items attributes, including title, description, reviews, etc.

Zend_Service_Amazon_Image represents a remote Image for a product.

Zend_Service_Amazon_ResultSet objects are returned by Zend_Service_Amazon::itemSearch() and allow you to easily handle the multiple results returned.

	SeekableIterator
	Implements the SeekableIterator for easy iteration (e.g. using foreach), as well as direct access to a specific result using seek().

Each result returned by Zend_Service_Amazon::itemSearch() and Zend_Service_Amazon::itemLookup() contains a Zend_Service_Amazon_OfferSet object through which pricing information for the item can be retrieved.

Each offer for an item is returned as an Zend_Service_Amazon_Offer object.

When searching for items, Amazon also returns a list of similar products that the searcher may find to their liking. Each of these is returned as a Zend_Service_Amazon_SimilarProduct object.

Each object contains the information to allow you to make sub-sequent requests to get the full information on the item.

Accessories for the returned item are represented as Zend_Service_Amazon_Accessories objects

Each Customer Review is returned as a Zend_Service_Amazon_CustomerReview object.

Each items Editorial Reviews are returned as a Zend_Service_Amazon_EditorialReview object

Each results List Mania List items are returned as Zend_Service_Amazon_Listmania objects.