利用マニュアル - アイスタイル

利用マニュアル
Ｖｅｒ 4.0 （２０１３年４⽉）
00
ＯＰＥＮ！
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
ＩＮＤＥＸ
利⽤規約および以下に同意のうえ、表記ガイドラインをよくお読み頂き、これに従ってご利⽤ください。
① クチコミの強要や恣意的な評価操作に相当する⾏為を⾏わないことを遵守します。
② サイト運営者によるクチコミの削除、ランキング集計対象外の措置、中⽴で公平なサイト運営を目的とした措置に異議を唱えません。
ＰＣサイト・スマートフォンサイト・フィーチャーフォンサイトでのご利⽤共にこれらの内容が適⽤されます。本サービスをご利⽤されることによって同意頂いたものとさせて頂きます
ので、必ず事前によくご確認頂きますようお願い致します。利⽤規約・ガイドラインに違反していると判断される場合には、ＡＰＩキーを無効にし、サービスの提供を停止をさ
せて頂く場合があります。なお、提供データの修正、編集は一切禁止とします。
１．フォーマット形式取扱説明
１－１．フォーマット形式仕様
２．XML形式取扱説明
２－１．XML形式仕様
２－２．リクエストパラメータ
２－３．レスポンスデータ
２－４．効果ID一覧
２－５．年齢ID一覧
11
p.３
p.７
p.９
p.１２
p.16
p.17
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
フォーマット形式
2
2
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
１－１．フォーマット形式仕様（1/3）
◆ご利⽤⽅法
フォーマットタイプをお申込いただくと、下記のようなHTMLタグを提供させていただきますので、掲載先のページのお好きなところにそのまま貼り付けていただくだけで、
利⽤開始が可能となります。商品を複数お申込の場合は赤で囲んだ商品IDと記述のある箇所を商品毎に設定してください。
編集可能箇所はHTMLタグ例の⾚で囲んだ箇所のみとなり、それ以外の箇所は編集しないようにしてください。
カンマを消してしまうことでエラーとなり表示されなくなることがあります。
ＨＴＭＬタグ例）
<script type="text/javascript">
var net_cosme_setting = {
height : 1200,
width : 400,
frame_bg : '#F5F0EA',
title_bg : '#90C7BB',
サイズ・カラー
title_font : '#FFFFFF',
line : '#BDB8AD',
link :'#068681'
};
クチコミID
</script>
商品ID
APIキー
<script type="text/javascript" src="http://iapicos.com/format/generate/products/295960/reviews/?api_key=bc51f0b355c3a0e15ca
48f03193fd07b&review_id=1111,2222,3333,4444,5555"></script>
◆ご注意事項
APIキーの間違え、登録時に申請したドメイン以外からのアクセスなどエラーが発生した際には何も表示されない状態となります。
編集可能な設定値や、APIキー、商品IDなどの項目以外を編集されますと、エラーが発生する原因になる場合があります。
編集可能箇所以外は編集しないようご注意ください。利⽤終了⽇を過ぎると何も表示されなくなりますのでご注意ください。
33
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
１－１．フォーマット形式仕様（2/3）
◆サイズ・カラー設定値について
HTMLタグ内にてサイズ設定、カラー設定の調整が可能となります。実際に設置する際の微調整などにご利⽤ください。
項目
項目名
height
縦サイズ
width
横サイズ
frame_bg
title_bg
title_font
フレームカラー
タイトル背景カラー
内容
数値指定。単位はピクセル(px)となります。表示サイズの調整にご利⽤ください。
RGB値指定。
ページに貼り付けてみた際に申込時に設定した⾊ではなく、他の⾊に変えたい場合などにご利⽤ください。
タイトルテキストカラー
line
ラインカラー
link
リンクカラー
◆クチコミID指定機能
タグ内のURLにクチコミIDを指定することで、指定したクチコミのみを表示させることが可能となります。
review_idの部分にカンマ区切りで指定したIDのクチコミのみ表示されます。
HTMLタグ例で1ページの3件クチコミを表示する設定の場合、1111,2222,3333の順にクチコミが表示され、2ページ目に4444,5555が表示されます。
※ユーザによりクチコミが削除されるなど、指定したクチコミが表示されなくなることがあります。表示件数が減ることを避けるため、多めに設定することをオススメします。
HTMLタグ例にて2222が削除された場合、1111,3333,4444が表示されることになります。
※クチコミIDは該当商品のクチコミのみ指定可能です。違う商品のクチコミを指定しても取得できません。
※クチコミIDは下記URLより参照いただけるクチコミ詳細ページのURLからご確認いただけます。 URL末尾の数値部分（⾚字部分）がクチコミIDとなります。
http://www.cosme.net/product/product_id/273190/review/501896763
◆環境
・httpsページやJavaScript（<script>タグ）の埋め込みが不可能なページではご利⽤になれません。
・推奨閲覧環境：windows ＩＥ7.0、8.０
・導⼊するサイトに実装可能かは、サービス資料「P.25」のサンプルで動作が確認頂けます。
・スマートフォンで閲覧時に一部機種でサイズ指定が無効になる場合があります。事前にサンプルで表示をご確認ください。
44
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
１－１．フォーマット形式仕様
（３/3）
③
ＨＴＭＬのタグ内で以下を自由に設定することができます。
④
①縦サイズ height : 1200,
②横サイズ width : 400,
⑤
③フレーム
frame_bg : '#F5F0EA',
④タイトル背景 title_bg : '#90C7BB',
①
⑤タイトルテキストカラー title_font : '#FFFFFF',
⑥
⑥ラインカラー line : '#BDB8AD',
⑦
⑦リンクカラー link :'#068681'
※背景⾊およびフォントカラーの指定はできません。
②
5
5
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
ＸＭＬ形式
6
6
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－１．XML形式仕様（1/2）
◆通信⽅式
通信方式はHTTPとし、リクエストパラメータはGET方式にてお渡しください。
リクエスト例）クチコミ情報を感謝件数順、おすすめ度3以上、年齢20歳から34歳、サンプル・モニターを除いて出⼒する場合
http://i-apicos.com/products/273190/reviews/?api_key= {api_key}
&count=5&offset=1&sort_kind=1&sort_order=1&recommend=3&age_min_limit=120&age_max_limit
=134&except_sample=1
◆出⼒形式
XML形式での提供となります。XML宣言は以下の通りです。
<?xml version="1.0" encoding="utf-8" ?>
◆HTTPリクエストヘッダ
リクエストには以下のHTTPヘッダが必須となります。
ヘッダタグ名
内容
Accept
application/xmlを含む (qvalueは0より大きい値を指定する)
Content-Type
リクエストボディのフォーマットを設定(application/xml)
Referer
申し込み時に指定したapicosを利⽤するサイトのURLを設定してください。認証にて使⽤させていただきます。
7
7
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－１．XML形式仕様（2/2）
◆エラー応答
エラー時のHTTPステータスコードは状況に応じ以下のように応答します。
Status（エラーコード）
Reason（エラーメッセージ）
内容
400
BAD_REQUEST
渡されたパラメーターがAPIで期待されたものと一致しない場合
401
NOT_AUTHORIZE
認証に失敗した場合
404
NOT_FOUND
指定したリソースが存在しない場合
500
INTERNAL_SERVER_ERROR
内部的な問題によってデータを返すことができない場合
※メニューの利⽤終了⽇過ぎた場合もエラーとなりますのでご注意ください。
エラーの構造は全てのAPIで統一となります。
出⼒例（エラーコード400の場合）
<?xml version="1.0" encoding="utf-8" ?>
<error>
<status>400</status>
<reason>Bad Request</reason>
</error>
8
8
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－２．リクエストパラメータ（1/3）
URI
http://www.i-apicos.com/products/{product_id}/reviews/
Method
GET
No
パラメーター名
必須
○
内容
1
api_key
2
count
１ページあたりのクチコミ取得件数
3
offset
4
sort_kind
設定値
指定形式
APIキー
説明
⽂字列
弊社より発⾏されるものをそのままご指定下さい。
デフォルト値：1
数値
開始番号
デフォルト値：1
数値
ソート種別
0：新着順（デフォルト値）
数値
1度に取得するクチコミの件数をご指定いただけます。１ページあたりのクチコ
ミ取得件数は1〜20の範囲で値を指定することができます。
この値が指定されなかった場合、取得件数は1件となります。
複数ページに分けて表示をする場合に何件目から表示するかを指定
いただけます。指定しない場合、1となります。
「1ページあたりのクチコミ取得件数」に応じて指定して下さい。
例）「1ページあたりのクチコミ取得件数」が5件の場合
2ページ目を取得したい場合は「開始番号」に6を指定。
3ページ目を取得したい場合は「開始番号」に11を指定します。
1：感謝件数順
クチコミの並び替え順序を指定いただけます。
2：おすすめ度順
3：年代順
5
sort_order
ソート昇順・降順
0：昇順
数値
1：降順（デフォルト値）
6
recommend
オススメ度
0：指定なし（デフォルト値）
数値
1：1以上
2：2以上
3：3以上
7
effect
効果
数値
※効果一覧参照
8
skin_type
肌質
0：指定なし（デフォルト値）
「ソート種別」で指定した項目の昇順・降順を指定いただけます。
＠ｃｏｓｍｅにてクチコミについている星印で表現されている「おすすめ度」
をを指定いただけます。指定した数値以上の「おすすめ度」のクチコミのみを
取得したい場合にご指定下さい。
＠ｃｏｓｍｅにてクチコミする際に選択可能な「効果・機能」をご指定
いただけます。効果一覧のＩＤを指定いただくと、指定した効果を選択し投
稿されたクチコミのみ取得いただけます。
数値
1：普通肌
2：乾燥肌
＠ｃｏｓｍｅにてクチコミしたメンバーの「肌質」をご指定いただけます。
指定した肌質のメンバーによって投稿されたクチコミのみ取得いただけます。
3：脂性肌
4：混合肌
5：敏感肌
6：アトピー
9
9
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－２．リクエストパラメータ（2/3）
9
hair_type
髪質
0：指定なし（デフォルト値）
数値
1：硬い
2：普通
3：柔らかい
10 hair_volume
髪量
0：指定なし（デフォルト値）
＠ｃｏｓｍｅにてクチコミしたメンバーの「髪質」をご指定いただけます。
指定した髪質のメンバーによって投稿されたクチコミのみ取得いただけます。
※対象商品のアイテムカテゴリによって
数値
1：多い
＠ｃｏｓｍｅにてクチコミしたメンバーの「肌質」をご指定いただけます。
指定した肌質のメンバーによって投稿されたクチコミのみ取得いただけます。
2：普通
3：少ない
11 age_min_limit
年齢(下限)
12 age_max_limit
年齢(上限)
13 purchase
購⼊場所
数値
※年齢ID一覧参照
数値
※年齢ID一覧参照
0：指定なし（デフォルト値）
＠ｃｏｓｍｅにてクチコミしたメンバーの「年齢」の範囲をご指定いただけま
す。指定された範囲の年齢のメンバーによって投稿されたクチコミのみ取得い
ただけます。
数値
1：デパート
2：スーパー・ドラッグ
＠ｃｏｓｍｅにてクチコミしたメンバーの「購⼊場所」をご指定いただけま
す。指定した購⼊場所で購⼊したメンバーによって投稿されたクチコミのみ取
得いただけます。
3：バラエティショップ
4：化粧品専門店
5：コンビニエンスストア
6：通販化粧品・コスメ
7：訪問販売
14 extrd
クチコミ投稿期間
7：今⽇
数値
1：1週間以内
2：1ヶ月以内
取得するクチコミの「投稿⽇」の期間をご指定いただけます。
指定された期間内のクチコミのみ取得いただけます。
3：3ヶ月以内
4：6ヶ月以内
5：1年以内
6：2年以内（デフォルト値）
15 freeword
キーワード指定
⽂字列
10
10
指定したキーワードをクチコミ本⽂に含むクチコミに絞り込んだクチコミのみ
取得いただけます。スペース区切りでand検索が可能となります。キーワード
は⽂字コードutf-8の⽂字列をURLエンコードし、設定してください。
例1）さわやか →
%E3%81%95%E3%82%8F%E3%82%84%E3%81%8B
例2）肌　うるおい →
%E8%82%8C%E3%80%80%E3%81%86%E3%82%8B%
E3%81%8A%E3%81%84
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－２．リクエストパラメータ（3/3）
16 view_condition
表示条件
0：クチコミのみ（デフォルト値）
数値
1：評価のみ
2：指定なし
17 except_sample
サンプル・モニターを除く
0：指定なし（デフォルト値）
数値
取得するクチコミにサンプルやモニターとして使⽤したものを含むかどうかを
指定いただけます。サンプル・モニターを除くを指定した場合、
サンプルやモニターとして使⽤したクチコミを省くことができます。
数値
取得するクチコミにリピートで使⽤したものを含むかどうかを
指定いただけます。リピートのみを指定した場合、
リピートで使⽤したクチコミのみを取得することができます。
1：サンプル・モニターを除く
18 repeat_only
リピートのみ
0：指定なし（デフォルト値）
取得するクチコミの「表示条件」をご指定いただけます。
「クチコミのみ」を指定するとクチコミが記⼊されているものが取得でき、
「評価のみ」を指定するとクチコミを記⼊せず、評価だけしたものが
取得できます。
1：リピートのみ
19 review_descriptions_le
ngth
クチコミ本⽂⽂字数
デフォルト値：0
数値
取得するクチコミ本⽂の⻑さをご指定いただけます。
0〜2000までの数値で指定ができ、指定しない場合、クチコミ本⽂が
取得いただけませんので、ご注意ください。
20 review_id
クチコミID
デフォルト値：指定なし
数値
取得するクチコミをIDでピンポイントにご指定いただけます。
IDはカンマ区切りで複数指定できます。
クチコミＩＤ指定機能では、カンマ区切りでクチコミを複数指定することがで
きます。指定した順番通りにクチコミが出⼒されます。取得件数以上に指定
した場合、取得件数分のみ出⼒がされます。開始番号の指定で取得件数
以上に指定したものも出⼒可能となります。
例）review_id=1111,2222,3333,4444,5555
取得件数3件で、開始番号を指定しないと1111,2222,3333の順で3件
表示されます。
取得件数3件で、開始番号に4を指定すると、4444,5555の順で2件の
み出⼒されます。
11
11
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－３．レスポンスデータ（1/4）
No
必須
繰返タグ名
データ型
データカテゴリ
項目名
説明
1
○
review
-
2
○
header
-
3
○
cosme_image
string
＠cosmeロゴイメージ
＠ｃｏｓｍｅロゴイメージ画像URLが出⼒されます。　※１
4
○
cosme_mobile_image
string
＠cosmeロゴイメージ(モバイル)
モバイル⽤の＠ｃｏｓｍｅロゴイメージ画像URLが出⼒されます。※２
5
○
cosme_top_link
string
＠cosmeTOPリンク
6
○
cosme_top_mobile_link
string
＠cosmeTOPリンク(モバイル)
7
○
offset
number
開始番号
取得件数
8
○
total_count
number
総件数
取得件数
(ヘッダー情報)
9
maker_id
number
メーカーID
商品情報
該当ブランドが属するメーカーの識別⼦が数字で出⼒されます。
10
maker_name
string
メーカー名
商品情報
該当ブランドが属するメーカー名が⽂字列で出⼒されます。
11
maker_name_link
string
メーカー名リンク
12
brand_id
number
ブランドID
商品情報
13
14
brand_name
brand_name_link
string
string
ブランド名
ブランド名リンク
商品情報
15
brand_name_mobile_link
string
ブランド名リンク(モバイル)
16
product_id
number
商品ID
商品情報
17
obsoleted
string
廃盤フラグ
商品情報
product_images
-
(商品画像)
product_image
string
product_mobile_images
-
18
19
20
○
商品情報
商品画像
(商品画像モバイル)
12
12
リンク設定が＠ｃｏｓｍｅになっている場合、メーカTOPページのURLが出⼒されます。
任意設定の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://www.cosme.net/maker/maker_id/1349
該当商品の属するブランド、もしくは指定したブランドの識別⼦が数字で出⼒されます。
ブランドをパラメータに指定する場合、こちらのIDを使⽤します。
該当商品の属するブランド、もしくは指定したブランド名が⽂字列で出⼒されます。
リンク設定が＠ｃｏｓｍｅになっている場合、ブランドTOPページのURLが出⼒されます。任意設
定の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://www.cosme.net/brand/brand_id/2892/top/nt
リンク設定が＠ｃｏｓｍｅになっている場合、ブランドTOPページのURLが出⼒されます。任意設
定の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://m.cosme.net/cosmeet/product/base/brand/bid/2892
該当商品の識別⼦が数字で出⼒されます。商品をパラメータに指定する場合、こちらのIDを使⽤
します。
既に廃盤となっている商品の場合、「生産終了」という⽂字列が出⼒さます。
＠ｃｏｓｍｅ画⾯では容量価格の部分に（生産終了）と表示されているものになります。
商品画像URLが出⼒されます
複数画像が設定されている商品の場合、複数件出⼒されます。
サイズ：70×70
例）http://cdn-cosme.net/media/product/10019/101550_m.jpg
101550_m.gifの部分を以下のように置換してご利⽤いただくことで、
別サイズの画像もご利⽤いただけます。
101550_l.jpg（120×120）
101550.jpg（180×180）
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－３．レスポンスデータ（2/4）
21
○
product_mobile_image
string
22
product_image_link
string
商品画像リンク
23
product_image_mobile_link
string
商品画像リンク(モバイル)
商品情報
商品画像(モバイル)
24
product_name
string
商品名
25
product_name_link
string
商品名リンク
26
product_name_mobile_link
string
商品名リンク(モバイル)
grades
-
(グレード情報)
grade
-
29
capacity
string
容量
商品情報
30
price
string
価格
商品情報
31
sales_date
string
発売⽇
商品情報
32
add_sales_date
string
追加発売⽇
商品情報
33
product_spf
string
SPF
商品情報
34
product_pa
string
PA
商品情報
35
product_description
string
商品説明
商品情報
商品説明の⽂字列が出⼒されます。
36
product_add_description
string
追加説明
商品情報
商品説明の追加説明がある場合、追加説明の⽂字列が出⼒されます。
37
average_point
number
平均評価点
評価点
⼩数点第一位までの数値として出⼒されます。
27
28
○
商品情報
モバイル⽤の商品画像URLが出⼒されます
複数画像が設定されている商品の場合、複数件出⼒されます。
サイズ：60×60
例）
http://m.cosme.net/fitter/cdn/media/product/10019/101550.jpg?target=60x
60&size=fit&limit=10240
target=60x60の部分を以下のように置換してご利⽤いただくことで、
別のサイズの画像もご利⽤いただけます。
target=180x180（180×180）
リンク設定が＠ｃｏｓｍｅになっている場合、商品TOPページのURLが出⼒されます。任意設定
の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://www.cosme.net/product/product_id/273190/top
リンク設定が＠ｃｏｓｍｅになっている場合、商品TOPページのURLが出⼒されます。任意設定
の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://m.cosme.net/product/product_id/273190/top
該当商品名が⽂字列で出⼒されます。
リンク設定が＠ｃｏｓｍｅになっている場合、商品TOPページのURLが出⼒されます。任意設定
の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://www.cosme.net/product/product_id/273190/top
リンク設定が＠ｃｏｓｍｅになっている場合、商品TOPページのURLが出⼒されます。任意設定
の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://m.cosme.net/product/product_id/273190/top
(グレード)
13
13
「50ml」といった形式の⽂字列として出⼒されます。
上の価格と共に複数組み合わせがある場合、複数件出⼒されます。
「5,000円」といった形式でカンマ、円が⼊った⽂字列として出⼒されます。
下の容量と共に複数組み合わせがある場合、複数件出⼒されます。
「ｙｙｙｙ/ｍｍ/ｄｄ」の形式の⽂字列で出⼒されます。
設定されていない場合＠ｃｏｓｍｅ画⾯と同様に半角ハイフンが出⼒されます。
「ｙｙｙｙ/ｍｍ/ｄｄ」の形式の⽂字列で出⼒されます。
＠ｃｏｓｍｅの画⾯では発売⽇の脇に(2007/5/3追加発売)といった形式で
表示されているものになります。
「SPF10」といった形式の⽂字列で出⼒されます。
＠ｃｏｓｍｅの画⾯では商品説明の中に下のPAと共に
「SPF50+・PA+++」といった形式で表示されているものになります。
「PA++」といった形式の⽂字列で出⼒されます。
＠ｃｏｓｍｅの画⾯では商品説明の中に下のPAと共に
「SPF50+・PA+++」といった形式で表示されているものになります。
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－３．レスポンスデータ（3/4）
38
average_point_image
string
平均評価点画像
評価点
39
ranking_point
number
ランキングポイント
評価点
40
41
product_review_count
product_review_count_link
number
string
商品別クチコミ件数
商品別クチコミ件数リンク
評価点
42
product_review_count_mobile_link
string
商品別クチコミ件数リンク(モバイル)
43
44
product_attention_count
product_attention_count_link
number
string
注目⼈数
注目⼈数リンク
45
item_categories
-
(アイテムカテゴリ情報)
46
○
(アイテムカテゴリ)
item_category
-
47
item_category_name
string
アイテムカテゴリ
48
item_category_link
string
アイテムカテゴリリンク
49
product_shopping_site_link
string
50
51
52
53
54
○
評価点
点数に応じた画像URLが出⼒されます。
⼩数点第一が０．５以上の時に、半分の★が表示されます。
例）
http://cdn-cosme.net/images/api/average_image/ico_star_large_all_045.png
拡張⼦をpngからgifに置換することでgif画像もご利⽤可能となります。
⼩数点第一位までの数値として出⼒されます。
ポイントがないときは、＠ｃｏｓｍｅ画⾯と同様に半角ハイフンが出⼒されます。
＠ｃｏｓｍｅページ内でポイントの横に王冠マークが表示されていますが、
その画像を下記URLにてご利⽤頂くことも可能です。
（XMLでの出⼒はありません）
http://cdn-cosme.net/images/api/point_icons/ico_csm_point.gif
商品に紐付くクチコミの件数が数字で出⼒されます。
リンク設定が＠ｃｏｓｍｅになっている場合、管理画⾯で設定された条件で絞り込まれた状態の
商品別クチコミページのＵＲＬが出⼒されます。任意設定の場合、設定したＵＲＬが出⼒され、
リンクなし設定の場合、空で出⼒されます。
例）
http://www.cosme.net/product/product_id/273190/reviews/rec/5/ord/rec
リンク設定が＠ｃｏｓｍｅになっている場合、商品別クチコミページのＵＲＬが出⼒されます。任
意設定の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://m.cosme.net/product/product_id/273190/reviews
該当商品をクリップしているメンバーの⼈数が数字で出⼒されます。
リンク設定が＠ｃｏｓｍｅになっている場合、この商品をクリップしているメンバー一覧ページの
URLが出⼒されます。任意設定の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空
で出⼒されます。
例）http://www.cosme.net/product/product_id/273190/beautists
商品情報
ショッピングサイトリンク
(ボディー情報)
body
-
detail
-
review_id
nick_name
age
string
string
number
クチコミID
ニックネーム
年齢
「大カテゴリ＞中カテゴリ＞⼩カテゴリ」の形式の⽂字列が出⼒されます。
複数のカテゴリに登録されている商品の場合、複数件出⼒されます。
リンク設定が＠ｃｏｓｍｅになっている場合、アイテムカテゴリTOPページのURLが出⼒されます。
任意設定の場合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://www.cosme.net/item/item_id/1113/top
リンク設定が＠ｃｏｓｍｅになっている場合、購⼊ページのURLが出⼒されます。任意設定の場
合、設定したＵＲＬが出⼒され、リンクなし設定の場合、空で出⼒されます。
例）http://www.cosme.com/product/pdt_dtl/item_id/1000011567
(クチコミ情報)
クチコミ情報該当するクチコミの識別⼦が数字で出⼒されます。
メンバー情報該当メンバーのニックネームが⽂字列で出⼒されます。
メンバー情報該当メンバーの年齢が数字で出⼒されます。
55
skin_type
string
肌質
メンバー情報該当メンバーの肌質が⽂字列で出⼒されます。
56
57
member_review_count
point
number
number
メンバークチコミ投稿件数
おすすめ度
メンバー情報該当メンバーのクチコミ件数が数字で出⼒されます。
クチコミ情報クチコミ投稿時に評価しないを選択した場合のみ「評価しない」という⽂字列が出⼒され、それ以外
は0〜7の数値が出⼒されます。
14
14
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－３．レスポンスデータ（4/4）
58
point_image
string
おすすめ度画像
クチコミ情報
59
review_date
string
投稿⽇時
クチコミ情報
60
sample
boolean
サンプル・モニター
クチコミ情報
61
repeat
boolean
リピート
クチコミ情報
62
review_descriptions
string
クチコミ本⽂
クチコミ情報
63
review_continue_link
string
クチコミの続きを読むリンク
64
review_continue_mobile_link
string
クチコミの続きを読むリンク(モバイル)
65
favorite_points
number
クチコミへの感謝数
クチコミ情報
66
purchase
string
購⼊場所
クチコミ情報
67
effects
-
(効果)
effect
string
68
○
効果
※１
例）http://cdn-cosme.net/images/api/logo_image/logo.png
logo.pngの部分を以下のように置換してご利⽤いただくことで、別サイズの画像もご利⽤いただけます。
通常版
logo_s.png（90×29）、logo_s.gif（90×29）、logo_m.png（150×49）、logo_m.gif（150×49）
logo.gif（215×70）、logo.png（215×70）
緑と白が反転版
logo_w.png（215×70）、logo_w.gif（215×70）、logo_w_s.png（90×29）、
logo_w_s.gif（90×29）、logo_w_m.png（150×49）、logo_w_m.gif（150×49）
モノクロ版
logo_b.png（215×70）、logo_b.gif（215×70）、logo_b_s.png（90×29）
logo_b_m.png（150×49）、logo_b_m.gif（150×49）、logo_b_s.gif（90×29）
クチコミ投稿時に評価しないを選択した場合は空出⼒となり、それ以外は0〜7の点数に応じた星
の画像の画像URLが出⼒されます。
例）
http://cdn-cosme.net/images/api/review_image/ico_review_star_average06.png
拡張⼦をpngからgifに置換することでgif画像もご利⽤可能となります。
「ｙｙｙｙ/ｍｍ/ｄｄ　ｈｈ：ｍｍ：ｓｓ」の形式の⽂字列で出⼒されます。
サンプルもしくは、モニターでの利⽤だった場合、sampleという⽂字列が出⼒されます。そうでない場
合、空出⼒となります。　＠ｃｏｓｍｅページ内でクチコミの評価点の横にサンプルマークが表示されていますが、その画像を
下記URLにてご利⽤頂くことも可能です。（XMLでの出⼒はありません）
http://cdn-cosme.net/images/api/sample_icons/ico_spl.gif
リピートでの利⽤だった場合、repeartという⽂字列が出⼒されます。そうでない場合、空出⼒とな
ります。　＠ｃｏｓｍｅページ内でクチコミの評価点の横にリピートマークが表示されていますが、そ
の画像を下記URLにてご利⽤頂くことも可能です。（XMLでの出⼒はありません）
http://cdn-cosme.net/images/api/repeat_icons/ico_rpt.gif
リクエストパラメータの『クチコミ本⽂⽂字数』にて指定された⽂字数分のみ出⼒されまる。デフォルト
が０なので、指定しない場合、この項目は空出⼒となります。
クチコミページのURLが出⼒されます。クチコミの出⼒を150⽂字などに設定した場合に、本⽂の後
ろに「続きを読む」といったリンクを⽤意したり、クチコミ本⽂を出⼒しない場合に「クチコミを読む」と
いったリンクを⽤意することを想定した項目となっております。
例）http://www.cosme.net/product/product_id/273190/review/500888293
クチコミページのURLが出⼒されます。クチコミの出⼒を150⽂字などに設定した場合に、本⽂の後
ろに「続きを読む」といったリンクを⽤意したり、クチコミ本⽂を出⼒しない場合に「クチコミを読む」と
いったリンクを⽤意することを想定した項目となっております。
例）http://m.cosme.net/product/product_id/273190/review/500888293
クチコミ情報
※２
例）http://cdn-cosme.net/images/api/logo_mobile_image/logo-mobile.gif
logo-mobile.gifの部分を以下のように置換してご利⽤いただくことで、別サイズの画像もご利⽤いただけます。
通常版
logo-mobile_s.gif（90×32）、logo-mobile_m.gif（150×54）、logo-mobile_l.gif（240×86）
logo-mobile.gif（100×36）
緑と白が反転版
logo-mobile_w_s.gif（90×32）、logo-mobile_w.gif（100×36）、logo-mobile_w_l.gif（240×86）
logo-mobile_w_m.gif（150×54）
モノクロの画像
logo-mobile_b_s.gif（90×32）、logo-mobile_b.gif（100×36）、logo-mobile_b_l.gif（240×86）
logo-mobile_b_m.gif（150×54）
15
15
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－４．効果ID一覧
id
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
name
爽快感
うるおい
毛穴
ニキビ
美白
低刺激
メイク落ち
アンチエイジング
引き締め
顔のテカリ
UVカット効果
荒れ・乾燥
ナチュラルメイク
カバー⼒
毛穴カバー⼒
崩れにくい
マット
ツヤ
描きやすい
持ちがよい・落ちにくい
発⾊がよい
カール・ハリ
id
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
name
ボリュームアップ
ロング効果
ウォータープルーフ
にじみにくい・落ちにくい
トリートメント効果
フィット感
持ちがよい
肌の透明感・薄づき
パール・ラメ
はがれにくい
乾きが早い
爪にやさしい
シェイプアップサポート
デトックス・代謝を上げる
肌のハリ・弾⼒
リラックス
エチケット
デオドラント
ムダ毛処理
痩身・スリミング
美白(ボディ)
角質ケア(ボディ)
id
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
16
16
name
高クレンジング
ダマにならない
爪が変⾊しない
においが穏やか
さわやか系
セクシー系
スイート系
スパイシー系
⾹りがよい
さらさら
髪しっとり
セットキープ⼒
ストレート
ウェーブ
無⾹料
高SPF・PA
白くならない
角質ケア
目のくま
⽴体感
セパレート効果
お湯で落ちるマスカラ
id
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
name
爪が折れにくい
フローラル系
ユニセックス系
⾹り持続⼒
べたつかない
ボリュームダウン(ヘア)
ボリュームアップ(ヘア)
育毛ケア
地肌ケア
カラーリングケア
フケ・頭皮のかゆみ
口臭対策・口臭予防
⻭のホワイトニング
低カロリー
美容サポート
スキンケア(美容情報)
メイク(美容情報)
ヘア(美容情報)
ボディ(美容情報)
コストパフォーマンス
自然派化粧品・オーガニックコスメ
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
２－５．年齢ID一覧
id
1
110
111
112
113
114
115
116
117
118
119
name
10代
10歳
11歳
12歳
13歳
14歳
15歳
16歳
17歳
18歳
19歳
id
2
120
121
122
123
124
3
125
126
127
128
129
name
20代前半
20歳
21歳
22歳
23歳
24歳
20代後半
25歳
26歳
27歳
28歳
29歳
id
4
130
131
132
133
134
5
135
136
137
138
139
name
30代前半
30歳
31歳
32歳
33歳
34歳
30代後半
35歳
36歳
37歳
38歳
39歳
17
17
id
6
140
141
142
143
144
145
146
147
148
149
name
40代
40歳
41歳
42歳
43歳
44歳
45歳
46歳
47歳
48歳
49歳
id
7
150
151
152
153
154
155
156
157
158
159
name
50代
50歳
51歳
52歳
53歳
54歳
55歳
56歳
57歳
58歳
59歳
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.
お問合わせ先
各種資料ＤＬ先
■サービス資料：http://www.istyle.co.jp/File/apicos_service.pdf
■利⽤規約：http://www.istyle.co.jp/File/apicos_kiyaku.pdf
■表記ガイドライン：http://www.istyle.co.jp/File/apicos_guideline.pdf
■アカウント申請書：http://www.istyle.co.jp/File/apicos_acount.xls
■利⽤マニュアル： http://www.istyle.co.jp/File/apicos_manual.pdf
■利⽤申込書：（フォーマット形式）http://www.istyle.co.jp/File/apicos_application_format.xls
（XML形式）http://www.istyle.co.jp/File/apicos_application_xml.xls
■変更指示書：http://www.istyle.co.jp/File/apicos_modification_format.xls
■管理画⾯利⽤マニュアル：http://www.istyle.co.jp/File/apicos_manual_admin.pdf
■管理画⾯：http://www.i-apicos.com
お問い合わせ先
お問合せは、下記窓口宛にお願い致します。
株式会社アイスタイルａｐｉｃｏｓ運営事務局
• Mail
• Tel
• Fax
apicos＠cosme.net
0３－５５７５－１２６７
0３－５５７５－１２７７
18
18
copyright
copyright (c)
(c) All
All right
right reserved,
reserved, istyle
istyle Inc.
Inc.

Download Report