SellerListingSearch

説明

SellerListingSearch オペレーションでは、特定の出品者が出品している商品を検索できます。マーチャントが出品している商品を SellerListingSearch で検索することはできません。マーチャントが出品している商品を検索するには、 ItemLookup または ItemSearch MerchantId パラメータとともに使用します。

SellerListingSearch は、商品の出品IDまたはExchange IDを返します。通常これらの値は、商品の詳細を検索する際に SellerListingLookup で使用します。

SellerListingSearch リクエストは、最大で10個の商品を返します。デフォルトでは、最初の10件の商品が返されます。商品の残りのページ (最大10ページまで) を表示するには ListingPage パラメータを使用します。

Product Advertising API を使用するには、出品している商品が10万個未満の出品者でなければなりません。10万個以上の商品を出品している出品者に関しては、Product Advertising API の代わりに、Amazon在庫管理システムやマーチャント@ APIなどのほかの出品者APIを使用する必要があります。

[注]注意

SellerListingSearch では、出品者IDが必要です。つまり、このオペレーションを使用し、全ての出品者にまたがって検索を行うことはできません。Product Advertising API には、このような処理を行う出品者固有のオペレーションはありません。全ての出品者にまたがって検索するには、 ItemSearch または ItemLookupを使用します。

タイトルまたは商品の説明に "Newton" という単語が含まれる、マーケットプレイス内の商品を検索し、価格の高い順に商品を並べ替えます。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=SellerListingSearch&
SellerId=[A Seller ID]&
Keywords=Newton&
Sort=+price&
OfferStatus=Open    

このリクエストに対するレスポンスをレスポンス例に示します。

リクエストパラメータ

名前説明必須
ListingPage

返されるレスポンスのページ。ページあたり最大10件のリストが返されます。10件を超えるリストがあるカスタマーの場合、複数の結果ページが返されます。デフォルトでは最初のページが返されます。別のページを返すには、ページ番号を指定します。

タイプ: 正の整数

タイプ: 文字列

デフォルト: 1

制約: 最大値は500です。

いいえ
OfferStatus

商品が入手できる (Open) か入手できない (Closed) かを指定します。クローズ状態 (Closed) の商品は、製造中止または在庫切れになっている製品です。

タイプ: 文字列

デフォルト: Open

有効な値:Closed

いいえ
SellerId

出品者を一意に識別する半角英数字の文字列。これらの文字列は、Amazon によって作成され、出品者に割り当てられます。

有効な値: 有効なSeller ID

はい
Sort

Sortパラメータにより、出品者の出品情報の検索結果の並べ替え方法が指定できます。-bfp (Featuredリスト、デフォルト) は、US、UK、DEサイトにのみ適用されます。

タイプ: 文字列

デフォルト: なし

有効な値: -startdate | startdate | +startdate | -enddate | enddate | -sku | sku | -quantity | quantity | -price | price | +price | -title | title

いいえ
Title

商品名に基づいて商品を検索します。KeywordsとTitleは相互に排他的であり、各リクエストではどちらか一方しか指定できません。

タイプ: 文字列。値に複数の単語を指定する場合は、スペースを%20としてURLエンコードします。単語の順序は識別されず、大文字と小文字も区別されません。

タイプ: 文字列

デフォルト: なし

いいえ
ResponseGroup

返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。

タイプ: 文字列

デフォルト: SellerListing

いいえ

SellerListingSearch には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。

レスポンス例

次に示すのは、上の例の最初のリクエストで返されるレスポンスの一部です。

<SellerListing>
  <ExchangeId>Y02Y3120110Y3481102</ExchangeId> 
  <ListingId>0411W027887</ListingId> 
  <Title>Spartas, Dale C. (photographs by) and Steve Smith (text by): Just Labs</Title> 
  <Price>
    <Amount>2200</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$22.00</FormattedPrice> 
  </Price>
  <StartDate>2001-04-11</StartDate> 
  <EndDate>2004-03-26</EndDate> 
  <Status>Open</Status> 
  <Quantity>1</Quantity> 

  <Availability>Usually ships within 1-2 business days</Availability> 
 
  <Seller>
    <SellerId>A3U5ACHDJ10963</SellerId> 
    <Nickname>alphabooks</Nickname> 
  </Seller>
</SellerListing>
<SellerListing>
  <ExchangeId>Y01Y1679802Y5496404</ExchangeId> 
  <ListingId>0829W011414</ListingId> 
  <Title>Incredible Journey,Quad Movie Poster, 40" x 30",1963</Title> 
  <Price>
    <Amount>1975</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$19.75</FormattedPrice> 
  </Price>
  <StartDate>2004-08-29</StartDate> 
  <EndDate>2007-08-14</EndDate> 
  <Status>Open</Status> 
  <Quantity>1</Quantity> 
  
  <Availability>Usually ships within 1-2 business days</Availability> 
 
  <Seller>
    <SellerId>A1ZKKOH0E9LH0B</SellerId> 
    <Nickname>nostalgia_dot_com</Nickname> 
  </Seller>
</SellerListing>

レスポンス

名前説明
Amount 最低通貨単位(ペニーなど)を基準とした価格。
Availability 商品の発送可能時期。
CurrencyCode 金額の表示形式。
EndDate 商品の出品期限。
ExchangeId マーケットプレイス内の出品情報を一意に識別する文字列。Exchange IDは、第三者によって出品された全ての商品で使用できます。ExchangeId を使用する際には、該当する出品者 ID と ASIN も指定する必要があります。
FormattedPrice Web サイトでの表示金額。
ListingId 商品を一意に識別する文字列。
NickName 出品者を識別する文字列。
Price Amount、CurrencyCode、FormattedPrice を含む、価格情報のコンテナ。
Quantity 商品の在庫数。
Seller SellerId および Nickname を含む、出品者情報のコンテナ。
SellerId 出品者を識別するトークン。
StartDate 商品の出品開始日。
Status 商品がまだ入手できる (Open) かもう入手できない (Closed) かを指定します。クローズ状態 (Closed) の商品は、製造中止または在庫切れになっている製品です。
Title 商品のタイトル。

これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループを参照してください。

関連オペレーション