ショッピング

商品レビュー検索

Version 1

リクエストURL

XML

http://shopping.yahooapis.jp/ShoppingWebService/V1/reviewSearch

PHPserialize

http://shopping.yahooapis.jp/ShoppingWebService/V1/php/reviewSearch

JSONP

http://shopping.yahooapis.jp/ShoppingWebService/V1/json/reviewSearch

商品レビュー検索はYahoo!ショッピングで書き込まれた商品レビューを検索する事ができるAPIです。カテゴリ別やストア別等の切り口で、新着順や、レビュー数順で商品レビューの一覧を取得できます。（例　ゴルフクラブカテゴリの商品レビュー一覧）

リクエストパラメータ

「RESTリクエストの構築（GET）」をご参照ください。

パラメータ	値	説明
appid （必須）	string	アプリケーションID。詳細はこちらをご覧ください。
affiliate_type	yid/vc	Yahoo! JAPANアフィリエイト（yid）とバリューコマースアフィリエイト（vc）の選択。例：`affiliate_type=yid`
affiliate_id	string	Yahoo! JAPANアフィリエイトIDもしくは、バリューコマースアフィリエイトIDを入力。
callback	string	JSONPとして出力する際のコールバック関数名を入力する為のパラメータ。UTF-8でエンコードした文字列を入力する。
jan （※1必須）	integer	JANコード検索、JANコードによって一意の商品のレビュー一覧を取得します。例：`jan=4988601006200`
category_id （※1必須）	integer	カテゴリID、カテゴリIDによって指定したカテゴリの商品レビュー一覧を取得します。
product_id （※1必須）	integer	製品ID、製品IDによって一意の商品のレビュー一覧を取得します。例：`product_id=e8c175ee5dee0f73dc7bd5026606d97a`
person_id （※1必須）	integer	人物コード、人物コードによって指定した人物に関連する商品のレビュー一覧を取得します。例：`person_id=2640`
store_id （※1必須）	string	ストアID、ストアIDによって指定したストアの商品レビュー一覧を取得します。例：`store_id=hmv`
results	integer	結果数指定、取得する検索結果数の指定　デフォルト値は10件、最大値は50件
start	integer	オフセット、何件目から表示させるか（１件目は1）
sort	updatetime/review_rate	並べ替え、`updatetime`(更新時間順）/`review_rate`(レビュー評価点順）（デフォルト：`-updatetime`）降順は`-`、昇順は`%2B` 例：`sort=-review_rate`

サンプルリクエストURL

http://shopping.yahooapis.jp/ShoppingWebService/V1/reviewSearch?appid=<あなたのアプリケーションID>&category_id=4744

レスポンスフィールド

商品レビュー検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://shopping.yahooapis.jp/ShoppingWebService/V1/reviewSearch.xsd

フィールド	説明
ResultSet	クエリーレスポンスのすべてを含み、次の属性を持ちます。 totalResultsAvailable：検索数HIT数 totalResultsReturned：返された値の個数 firstResultPosition：最初のデータが何個目にあたるか（最初＝1）
Result	index: レビュー検索結果の順番
ReviewTitle	レビューのタイトル文（例：`購入しました！`）
Description	レビューの本文
Url	レビューページのURL
Update	レビューが更新された時間　`YYYY-MM-DDTHH:mm:SS+09:00`
ReviewType	レビューの種類 `buyer`（購入者）/`other`（クチコミ）/`all`（全員）
Purpose	購入目的 `daily`（購入者）/`hobby`（趣味用途）/`gift`（プレゼント）/`business`（仕事用）
SendTo	誰用に購入したか `self`（自分用）/`family`（家族親戚用）/`friend`（友人へ）/`lover`（彼氏彼女へ）/`business`（取引先へ）
Recommend	レビューを見て役立った人の数
Rate	レビュー評価点
Average	レビュー平均点
All	レビュー数
Target	type: レビューが書かれた対象の種類　`item`（商品）※商品のみ
Name	商品名
Code	商品コード
Url	商品URL
Id	ストアID
Url	ストアURL
Name	ストア名
Id	画像ID
ExtraSmall	76×76サイズの画像URL
Small	76×76サイズの画像URL
Medium	146×146サイズの画像URL
Id	カテゴリID　現在カテゴリ、リクエストパラメータがcategory_idの時のみ表示
ParentId	親カテゴリID
Url	おすすめカテゴリページURL
Short	カテゴリ名短
Medium	カテゴリ名　中
Long	カテゴリ名　長
Category	depth 数字　トップからのカテゴリの深さ
Id	カテゴリID
ParentId	親カテゴリID
Name	カテゴリ名
Child	sortOrder カテゴリの並び順　数値
Id	子カテゴリID
URL	おすすめカテゴリページURL
Short	カテゴリ名　短
Medeium	カテゴリ名　中
Long	カテゴリ名　長

サンプルレスポンス

以下は、category_idを4744（スイーツカテゴリ）でリクエストした場合のレスポンスです。

<?xml version="1.0" encoding="utf-8"?>
<ResultSet xsi:schemaLocation="urn:yahoo:jp:reviewSearch http://shopping.yahooapis.jp/ShoppingWebService/V1/reviewSearch.xsd"
totalResultsAvailable="1154" totalResultsReturned="2"
firstResultPosition="1">
  <Result index="1">
    <ReviewTitle>素晴らしい</ReviewTitle>
    <Description>全盛期Michael Jacksonを、完全に鑑賞出来る商品だと思う!
    お店の対応も迅速で良かった。</Description>
    <Ratings>
      <Rate>5.00</Rate>
      <Average>4.92</Average>
    </Ratings>
    <Count>
      <All>13</All>
    </Count>
    <Recommend>0</Recommend>
    <Update>2009-11-21T06:39:36+09:00</Update>
    <Url>
    http://shopping.yahoo.co.jp/review/item/list?store_id=hmv&amp;page_key=1447184</Url>
    <ReviewType>buyer</ReviewType>
    <Purpose>daily</Purpose>
    <SendTo>family</SendTo>
    <Target type="item">
      <Name>Michael Jackson　マイケル・ジャクソン / Live In Bucharest: The
      Dangerous Tour</Name>
      <Code>hmv_1447184</Code>
      <Url>http://store.shopping.yahoo.co.jp/hmv/1447184.html</Url>
      <Image>
        <Id>hmv_1447184</Id>
        <Small>
          <Url>
          http://a248.e.akamai.net/f/248/37952/1d/image.shopping.yahoo.co.jp/i/c/hmv_1447184</Url>
          <Width>76</Width>
          <Height>76</Height>
        </Small>
        <Medium>
          <Url>
          http://a248.e.akamai.net/f/248/37952/1d/image.shopping.yahoo.co.jp/i/g/hmv_1447184</Url>
          <Width>146</Width>
          <Height>146</Height>
        </Medium>
      </Image>
      <Store>
        <Id>hmv</Id>
        <Name>HMV Yahoo!店</Name>
        <Url>http://store.shopping.yahoo.co.jp/hmv</Url>
      </Store>
    </Target>
  </Result>
  <Result index="2">
    <ReviewTitle>ステキ</ReviewTitle>
    <Description>大好きなMichael Jacksonの集大成を味わえると思います!
    マジでカッコイイ!</Description>
    <Ratings>
      <Rate>5.00</Rate>
      <Average>0.00</Average>
    </Ratings>
    <Count>
      <All>2</All>
    </Count>
    <Recommend>0</Recommend>
    <Update>2009-11-21T06:36:54+09:00</Update>
    <Url>
    http://shopping.yahoo.co.jp/review/item/list?store_id=hmv&amp;page_key=3577389</Url>
    <ReviewType>buyer</ReviewType>
    <Purpose>daily</Purpose>
    <SendTo>family</SendTo>
    <Target type="item">
      <Name>Michael Jackson　マイケル・ジャクソン / ムーンウォーカー</Name>
      <Code>hmv_3577389</Code>
      <Url>http://store.shopping.yahoo.co.jp/hmv/3577389.html</Url>
      <Image>
        <Id>hmv_3577389</Id>
        <Small>
          <Url>
          http://a248.e.akamai.net/f/248/37952/1d/image.shopping.yahoo.co.jp/i/c/hmv_3577389</Url>
          <Width>76</Width>
          <Height>76</Height>
        </Small>
        <Medium>
          <Url>
          http://a248.e.akamai.net/f/248/37952/1d/image.shopping.yahoo.co.jp/i/g/hmv_3577389</Url>
          <Width>146</Width>
          <Height>146</Height>
        </Medium>
      </Image>
      <Store>
        <Id>hmv</Id>
        <Name>HMV Yahoo!店</Name>
        <Url>http://store.shopping.yahoo.co.jp/hmv</Url>
      </Store>
    </Target>
  </Result>
</ResultSet>

エラー

商品レビュー検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。（無料）
まずはヘルプページのお問い合わせフォームからご相談ください。

商品レビュー検索

リクエストURL

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

エラー

利用制限

商品レビュー検索を使用した開発に関するQ＆A

お役立ち度の高い解決済みの質問

Web APIとその他のサービス

API

その他

関連ドキュメント

開発者ブログ

開発者コミュニティ

開発のヒント

法人デベロッパー専用お問い合わせ