The SellerListingSearch operation enables you to search Marketplace listings. These sellers must have less than 150,000 items for sale. ECS does not support sellers that have more than 150,000 items.
Note:
SellerListingSearch cannot return listings for featured merchants' items. Only merchants with New, Used, Refurbished, and Collectible offerings are returned. To find items belonging to a specific featured merchant, use the ItemSearch operation, passing the merchant's ID in the MerchantId parameter.
The SellerListingSearch operation in the FR, CA, and JP locales use a different set of operation parameters, which is described below.
SellerListingSearch is available in all locales.
Using SellerListingSearch (REST)
This example demonstrates how SellerListingSearch can be used to search for marketplace items by title and have the results sorted by price.
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService&AWSAccessKeyId=[Your Access Key ID Here]&Operation=SellerListingSearch&Title=[A Title String]&Sort=+price&OfferStatus=Open
Request parameters specify the terms of your request and control the output data that is returned to you.
You must include the required parameters in every request.
SellerListingSearch accepts the optional parameters that are common to all operations:
The following parameters are specific to the SellerListingSearch operation:
| Parameter | Description | Required? | Value |
|---|---|---|---|
| Operation |
The operation. |
Always Required | SellerListingSearch |
| Title |
Use the Title parameter to refine your seller listing search to listings containing matching title words. The Title parameter accepts a string containing one or more title words. |
Valid Value:
|
|
| Sort |
Use the Sort parameter to specify how your seller listing search results will be ordered. |
Valid Values:
|
|
| ListingPage |
This parameter specifies which page of listings to return with the request, where a page is up to 10 search results at a time. Specifying 1 returns the first page (items 1 through 10), specifying 2 returns the second page (items 11 through 20), etc. The maximum ListingPage number that can be specified is 500. If you do not include ListingPage in your request, all of the listings are returned if there are less than 10, the first 10 are returned if there are more than 10. |
Always Optional |
Default Value:
Valid Values:
|
| OfferStatus |
Use the OfferStatus parameter to filter your seller listing search results by whether the offer status is closed (sold or unpurchasable) or open (purchasable). This parameter only applies to the US, UK, and DE locales. |
Default Value:
Valid Values:
|
|
| SellerId |
Use the SellerId to filter the results by a seller ID. If SellerId is the only parameter specified, the SellerListingSearch operation returns all of the seller's listings. |
Yes |
Valid Value:
|
| ResponseGroup |
Controls the data returned by the operation. Use this parameter to specify which response group(s), or group(s) of data elements, you would like Amazon E-Commerce Service (ECS) to return to you. You can specify as many response groups as you wish using a comma-separated list (REST) or multiple elements (SOAP). |
Always Optional |
Default Values Valid Values |