レビュー情報取得API
※レビュー情報取得APIは将来削除予定です。代わりに、レビュー情報取得APIを使用してください。
レビュー検索APIのオプションにcomIdを指定することで、同じ情報が取得できます。
レビュー情報取得APIとは、日本最大の動画付き商品レビューサイトconecoクラブでユーザが書き込みを行った商品のレビュー情報を取得するAPIです。
coneco.netでの、/ReviewList/商品ID/に相当し、 商品検索APIより得られた商品IDを指定することで、商品個別のユーザレビューを一度に取得します。
リクエストURL
- XML形式
- http://api.coneco.net/cws/v1/GetReview?apikey=***&comId=1070109001
- JSON or JSONP形式
- http://api.coneco.net/cws/v1/GetReview_json?apikey=***&comId=1070109001&callback=method
入力パラメータ
商品検索APIでの指定可能なパラメータの一覧です。
| 項目名 | フィールド名 | 型 | 必須 | デフォルト | 備考 |
|---|---|---|---|---|---|
| APIキー | apikey | String | ○ | - | 各ユーザごとのAPIキー |
| 商品ID | comId | integer | ○ | - | 商品固有のIDを指定する。 |
| ページ番号 | page | integer | ページ送りを行いたい場合に指定する。 | ||
| 表示件数 | count | integer | 20 | 1リクエストでの表示件数を指定する。(最大20件) | |
| コールバック関数 | callback | String | JSONP形式の場合のみ使用する、コールバック関数。 |
出力パラメータ
商品検索API使用時の結果一覧です。
| 項目名 | フィールド名 | 型 | 備考 |
|---|---|---|---|
| 共通ヘッダ | |||
| APIバージョン | APIVersion | String | APIのバージョンを表します |
| 該当件数 | Count | integer | 検索結果の該当件数を表します |
| 表示件数 | Size | integer | 1リクエスト当たりの表示件数を表します。(最大20件) |
| 現在のページ数 | Current | integer | 検索結果の何ページ目か表します。 |
| 状態 | Status | String | APIの問合せ結果をメッセージで返します。 |
| サービス固有パラメータ | |||
| 商品ID | ComId | integer | coneco.net固有の商品のIDを表します。 |
商品名![]() | Name | String | coneco.netでの商品名を表します。 |
商品画像URL![]() | ImageUrl | String | 商品画像を表すURL |
商品画像URL(小)![]() | SmallImageUrl | String | 商品画像を表すURL |
メーカー名![]() | Manufacturer | String | 製造メーカーを表します。 |
| レビュー評価 | AvgRatings | 商品個別の評価を表します。 | |
| レビュー数 | ReviewCount | integer | 商品に対して書かれているレビュー数を表します。 |
| ブックマーク数 | BookmarkCount | integer | 商品をブックマークしているユーザ数を表します。 |
| みんなの評価 | OverallRating | integer | 商品レビューでの総合評価の平均を表します。 |
| 項目ごとの評価 | Rating | String | title(項目):商品の評価項目を表します。 |
| String | 値:商品の評価項目ごとの評価を5段階で表します。 | ||
| 商品レビュー情報 | Review | 個別の商品レビュー | |
| レビューID | Id | integer | レビュー固有のIDを表します。 |
| レビュータイトル | Summary | String | レビューのタイトルを表します。 |
| レビューURL | Url | String | レビューのタイトルを表します。 |
| ユーザページ | AuthorUrl | String | レビューを書いた人のconecoクラブでのマイページのURLを表します。 |
| 良い点 | Pros | String | 商品の良い点を表します。 |
| 悪い点 | Cons | String | 商品の悪い点を表します。 |
| 満足度 | OverallRating | integer | レビューごとの総合評価を表します。 |
| レビュー内容 | Description | String | レビュー本文を表します。(最大全角150文字) |
| 購入情報 | Purchase | ||
購入金額![]() | Price | int | ユーザがレビュー対象の商品を購入した金額を表します。 |
購入日時![]() | Date | String | ユーザがレビュー対象の商品を購入した日時を表します。 |
| 作成日 | Created | String | レビュー作成日時 |
| レビュー評価 | Ratings | ||
| 項目ごとの評価 | Rating | String | title(項目):レビューごとの商品の評価項目を表します。 |
| String | 値:レビューごとの評価項目ごとの評価を5段階で表します。 | ||
サンプル出力
検索条件:商品ID「1060114050」(Realforce101(PS/2) ML0100)に属する、レビューの一覧を取得する。
http://api.coneco.net/cws/v1/GetReview?apikey=******&comId=1040908007
<?xml version="1.0" encoding="UTF-8"?>
<ItemInfo xmlns="http://api.coneco.net/cws/v1/">
<Header>
<APIVersion>1.3.0</APIVersion>
<Page>
<Count>1</Count>
<Size>1</Size>
<Current>1</Current>
</Page>
<Status>Success</Status>
</Header>
<Item>
<ComId>1040908007</ComId>
<Name>Realforce101(PS/2) ML0100</Name>
<ImageUrl>http://img.coneco.net/co/1040908007.gif</ImageUrl>
<SmallImageUrl>http://img.coneco.net/co/s/1040908007s.gif</SmallImageUrl>
<Manufacturer>東プレ/Topre</Manufacturer>
<AvgRatings>
<ReviewCount>1</ReviewCount>
<BookmarkCount>1</BookmarkCount>
<OverallRating>5</OverallRating>
<Rating title="機能性">5</Rating>
<Rating title="耐久性">5</Rating>
<Rating title="使いやすさ">5</Rating>
<Rating title="デザイン">4</Rating>
<Rating title="価格">4</Rating>
</AvgRatings>
</Item>
<Reviews comId="1040908007">
<Review>
<Id>3</Id>
<Summary>最高のキーボード</Summary>
<Url>http://club.coneco.net/user/19/review/3/</Url>
<AuthorUrl>http://club.coneco.net/user/19/</AuthorUrl>
<Pros>打鍵感覚が非常に軽快</Pros>
<Cons>持ち運びには不向き(1.4Kg)</Cons>
<OverallRating>5</OverallRating>
<Description>最高級品質を誇るRealforceの英語キーボード版。
正直、英語キーボードのテンキーレス版をいつでるのか首を長くして2,3年待っていたのだが、転職をきっかけに購入。
今までは、会社で初代HHKを使用していたが、Realforceを購入後自宅でしばらく使おうかと思っていたが、ちょっと文章をRealfoc
</Description>
<Purchase>
<Price>18600</Price>
<Date>2006/11/10</Date>
</Purchase>
<Created>2006-12-14 18:32:33.067</Created>
<Ratings>
<Rating title="機能性">5</Rating>
<Rating title="耐久性">5</Rating>
<Rating title="使いやすさ">5</Rating>
<Rating title="デザイン">4</Rating>
<Rating title="価格">4</Rating>
</Ratings>
</Review>
</Reviews>
</ItemInfo>


