Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント
Amazon MWS ドキュメント

ListMatchingProducts

検索クエリに応じた、商品およびその属性のリストを返します。

説明

ListMatchingProductsオペレーションは、指定した検索クエリに応じた、商品およびその属性のリストを関連性の高い順に返します。検索クエリには、商品を表す文字列、またはGCID、UPC、EAN、ISBN、JANなどの商品IDを指定できます。商品のASINが分かっている場合は、GetMatchingProductオペレーションを使用します。商品IDとしてSellerSKUは指定できません。条件に一致する商品がない場合、キーワードのスペルを訂正するかキーワードを減らすことでクエリの検索対象が拡大されます。最大で10商品を返し、購入不可商品は含まれません。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。

スロットリング

最大リクエストクォータ 回復レート 時間あたりのリクエストクォータ
20リクエスト 5秒あたり1回のリクエスト 1時間あたり720リクエスト
スロットリング用語の定義およびスロットリングの詳しい説明については、Amazon MWS開発者ガイドスロットリング:リクエストの送信頻度を制限するを参照してください。商品ごとのスロットリングの詳細については、商品APIのスロットリングを参照してください。

リクエストパラメーター

すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイド必須のリクエストパラメーターを参照してください。

名前 説明 必須 推奨値
MarketplaceId マーケットプレイスID。商品情報を取得したいマーケットプレイスを指定する。

タイプ:xs:string

はい MarketplaceId値の一覧については、Amazon MWS開発者ガイドAmazon MWSエンドポイントとMarketplaceId値を参照してください。
Query AmazonのマーケットプレイスWebサイトで使用可能な検索文字列に対応。

例: Query=harry potter dvd

タイプ:xs:string

はい  
QueryContextId 指定した検索が実行されるコンテキストのID。マーケットプレイスによっては、制約を加えて商品の一部を検索する仕組みが提供されていることがある。たとえばAmazonマーケットプレイスでは、特定のカテゴリーに絞ったクエリが可能で、QueryContextIdパラメーターを使って指定する。省略した場合、そのマーケットプレイスのデフォルトのコンテキスト(通常、最大の商品一式が含まれる)を用いて検索を行う。

タイプ:xs:string

いいえ Amazonの各マーケットプレイスで使用可能なQueryContextId値の一覧は、QueryContextId値を参照。

レスポンス要素

ListMatchingProductsオペレーションが返すレスポンス要素は、一般に公開されている次のXSDで内容を確認できます。

以下の表は、ListMatchingProductsオペレーションで返される主要な要素に関する追加情報です。

注: Amazon MWS商品APIセクションは、新しいレスポンス要素を追加して更新しているため、ProductsAPI_Response.xsdスキーマとdefault.xsdスキーマも更新する場合があります。これらのスキーマを検証に使用する場合は、ご注意ください。
名前 説明
Product ProductsAPI_Response.xsdのProduct要素の4つのサブ要素を含む。サブ要素:IdentifiersAttributeSetsRelationshipsSalesRankings
Identifiers 商品を一意に識別するMarketplaceASINの組み合わせを含む。
AttributeSets 返された商品に該当する場合は、default.xsdのItemAttributes要素の商品の属性を含む。属性の言語が複数ある場合、Productレスポンス要素には複数の属性セットが含まれます。翻訳されていない属性も含め、すべての属性がそれぞれの属性セットで繰り返されます。それぞれの属性セットで使用される言語は、lang属性で示されます。
Relationships 商品のバリエーション情報がある場合は、これに含まれます。バリエーションの親ASINで識別される商品が検索条件に一致する場合、関連するVariationChild要素がRelationships要素に含まれます。バリエーションの子ASINが検索条件に一致する場合、関連するVariationParent要素がRelationships要素に含まれます。
注: このオペレーションが返すのは商品の属性の一部でしかないため、VariationChild要素にはバリエーション要素の値が同じ、別のASIN値が含まれている場合があります。それぞれを区別する商品属性が返されない場合でも、バリエーションの子ASINは区別されます。

バリエーション属性は、default.xsdのVariationChild要素に含まれます。

注: 入力されたASIN値に2,000以上のVariationChild要素の組み合わせがある場合、バリエーション属性はVariationChild要素には含まれません。
SalesRankings 商品カテゴリー別の商品売上ランキング情報。

サブ要素:

  • ProductCategoryId。売上ランキングの対象の商品カテゴリーを指定する。
  • Rank。商品カテゴリー内の商品の売上ランク。

クエリリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

サンプルを表示するサンプルを隠す

POST /Products/2011-10-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=ListMatchingProducts
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&Query=0439708184
&SellerId=A1IMEXAMPLEWRC
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-12T22%3A23%3A50Z
&Version=2011-10-01
&Signature=V%2BEXAMPLERT%2Baj%2Fxwqo7y3PIifMFHeqFlNYW0EXAMPLEA%3D

↑ トップへ戻る

レスポンス例

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<ListMatchingProductsResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <ListMatchingProductsResult>
        <Products xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"
            xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
            <Product>
                <Identifiers>
                    <MarketplaceASIN>
                        <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                        <ASIN>059035342X</ASIN>
                    </MarketplaceASIN>
                </Identifiers>
                <AttributeSets>
                    <ns2:ItemAttributes xml:lang="en-US">
                        <ns2:Author>Rowling, J.K.</ns2:Author>
                        <ns2:Binding>Paperback</ns2:Binding>
                        <ns2:Brand>Scholastic Press</ns2:Brand>
                        <ns2:Creator Role="Illustrator">GrandPré, Mary</ns2:Creator>
                        <ns2:Edition>1st</ns2:Edition>
                        <ns2:Feature>Recommended Age: 9 years and up</ns2:Feature>
                        <ns2:ItemDimensions>
                            <ns2:Height Units="inches">0.80</ns2:Height>
                            <ns2:Length Units="inches">7.50</ns2:Length>
                            <ns2:Width Units="inches">5.20</ns2:Width>
                            <ns2:Weight Units="pounds">0.50</ns2:Weight>
                        </ns2:ItemDimensions>
                        <ns2:IsAutographed>false</ns2:IsAutographed>
                        <ns2:IsMemorabilia>false</ns2:IsMemorabilia>
                        <ns2:Label>Scholastic Paperbacks</ns2:Label>
                        <ns2:Languages>
                            <ns2:Language>
                                <ns2:Name>english</ns2:Name>
                                <ns2:Type>Unknown</ns2:Type>
                            </ns2:Language>
                            <ns2:Language>
                                <ns2:Name>english</ns2:Name>
                                <ns2:Type>Original Language</ns2:Type>
                            </ns2:Language>
                            <ns2:Language>
                                <ns2:Name>english</ns2:Name>
                                <ns2:Type>Published</ns2:Type>
                            </ns2:Language>
                        </ns2:Languages>
                        <ns2:ListPrice>
                            <ns2:Amount>10.99</ns2:Amount>
                            <ns2:CurrencyCode>USD</ns2:CurrencyCode>
                        </ns2:ListPrice>
                        <ns2:Manufacturer>Scholastic Paperbacks</ns2:Manufacturer>
                        <ns2:NumberOfItems>1</ns2:NumberOfItems>
                        <ns2:NumberOfPages>320</ns2:NumberOfPages>
                        <ns2:PackageDimensions>
                            <ns2:Height Units="inches">1.00</ns2:Height>
                            <ns2:Length Units="inches">7.50</ns2:Length>
                            <ns2:Width Units="inches">5.20</ns2:Width>
                            <ns2:Weight Units="pounds">0.50</ns2:Weight>
                        </ns2:PackageDimensions>
                        <ns2:PackageQuantity>1</ns2:PackageQuantity>
                        <ns2:PartNumber>9780590353427</ns2:PartNumber>
                        <ns2:ProductGroup>Book</ns2:ProductGroup>
                        <ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName>
                        <ns2:PublicationDate>1999-10-01</ns2:PublicationDate>
                        <ns2:Publisher>Scholastic Paperbacks</ns2:Publisher>
                        <ns2:ReleaseDate>1999-09-08</ns2:ReleaseDate>
                        <ns2:SmallImage>
                            <ns2:URL>
                                http://ecx.images-amazon.com/images/I/51MU5VilKpL._SL75_.jpg
                            </ns2:URL>
                            <ns2:Height Units="pixels">75</ns2:Height>
                            <ns2:Width Units="pixels">51</ns2:Width>
                        </ns2:SmallImage>
                        <ns2:Studio>Scholastic Paperbacks</ns2:Studio>
                        <ns2:Title>Harry Potter and the Sorcerer's Stone (Book 1)</ns2:Title>
                    </ns2:ItemAttributes>
                </AttributeSets>
                <Relationships/>
                <SalesRankings>
                    <SalesRank>
                        <ProductCategoryId>book_display_on_website</ProductCategoryId>
                        <Rank>401</Rank>
                    </SalesRank>
                    <SalesRank>
                        <ProductCategoryId>15356791</ProductCategoryId>
                        <Rank>5</Rank>
                    </SalesRank>
                    <SalesRank>
                        <ProductCategoryId>3153</ProductCategoryId>
                        <Rank>8</Rank>
                    </SalesRank>
                    <SalesRank>
                        <ProductCategoryId>17468</ProductCategoryId>
                        <Rank>16</Rank>
                    </SalesRank>
                </SalesRankings>
            </Product>
        </Products>
    </ListMatchingProductsResult>
    <ResponseMetadata>
        <RequestId>3b805a12-689a-4367-ba86-EXAMPLE91c0b</RequestId>
    </ResponseMetadata>
</ListMatchingProductsResponse>

↑ トップへ戻る