ショッピング
コンテンツマッチランキング
Version 1
リクエストURL
XML
http://shopping.yahooapis.jp/ShoppingWebService/
PHPserialize
http://shopping.yahooapis.jp/ShoppingWebService/
JSONP
http://shopping.yahooapis.jp/ShoppingWebService/
指定されたURLのコンテンツのカテゴリを解析し、その内容にマッチするカテゴリのランキング情報をダイナミックに返す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でエンコードした文字列を入力する。 |
| url(必須) | string | 解析するコンテンツのURLを入力します。(URLはエンコードする必要があります) |
サンプルリクエストURL
http://shopping.yahooapis.jp/ShoppingWebService/V1/contentMatchRanking?※タイムアウトやコンテンツの読み込みができなかった場合、Yahoo!ショッピングのおすすめ順で商品情報を返します。精度向上とタイムアウト回避のためにコンテンツ解析タグの埋め込みを推奨しております。対応しているコンテンツ解析タグとクローラーについて、詳しくはこちらをご覧ください
レスポンスフィールド
コンテンツマッチランキングWeb APIのスキーマの記述は、以下のURLをご覧ください。
http://shopping.yahooapis.jp/ShoppingWebService/V1/contentMatchRanking.xsd
| フィールド | 説明 |
| ResultSet | クエリーレスポンスのすべてを含み、次の属性を持ちます。
|
| Url | リクエストしたURL |
| StartDate | 集計開始日(YYYY-mm- |
| EndDate | 集計終了日(YYYY-mm- |
| Last |
更新日(YYYY-mm- |
| Id | リクエスト category_idに入力した値 |
| RankingData | 商品のランキング情報
|
| Name | 商品名/製品名 |
| Url | 商品URL/製品URL(※1) |
| Id | 画像ID |
| Small | 76×76サイズの画像URL |
| Medium | 146×146サイズの画像URL |
| Id | ストアID |
| Name | ストア名 |
| Url | ストアURL(※1) |
| Id | 現在カテゴリID |
| ParentId | 親カテゴリID |
| Url | 現在カテゴリのおすすめページURL |
| Short | 現在カテゴリ名 |
| Medium | 現在カテゴリパス名1 |
| Long |
現在カテゴリパス名2 |
| Category | 商品カテゴリ
|
| Id | 現在カテゴリID |
| ParentId | 親カテゴリID |
| Name | カテゴリ名 |
| Children | 子カテゴリ群 |
| Child | 子カテゴリ
|
| Id | 子カテゴリID |
| Url | 子カテゴリのおすすめページURL |
| Short | 子カテゴリ名 |
| Medium | 子カテゴリパス名1 |
| Long | 子カテゴリパス名2 |
※1 商品URLはYahoo!ショッピングのストア商品ページへのリンク、製品URLはYahoo!ショッピング製品ページへのリンクになります。
サンプルレスポンス
以下は、Yahoo!ショッピングの特集ページURLの、リクエストに対するレスポンスです。
エラー
コンテンツマッチランキングWeb APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。(1クエリー/秒)
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。(無料)
まずはヘルプページのお問い合わせフォームからご相談ください。