ログイン
IDでもっと便利に[ 新規取得 ]

ショッピング

コンテンツマッチランキング

Version 1

リクエストURL

XML

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

PHPserialize

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

JSONP

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

指定された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?appid=<あなたのアプリケーションID>&url=http%3A%2F%2Fcontents.shopping.yahoo.co.jp%2Fwhatshot%2Ffashion%2F00006%2F

※タイムアウトやコンテンツの読み込みができなかった場合、Yahoo!ショッピングのおすすめ順で商品情報を返します。精度向上とタイムアウト回避のためにコンテンツ解析タグの埋め込みを推奨しております。対応しているコンテンツ解析タグとクローラーについて、詳しくはこちらをご覧ください

レスポンスフィールド

コンテンツマッチランキングWeb APIのスキーマの記述は、以下のURLをご覧ください。
http://shopping.yahooapis.jp/ShoppingWebService/V1/contentMatchRanking.xsd

フィールド 説明
ResultSet クエリーレスポンスのすべてを含み、次の属性を持ちます。

  • totalResultsAvailable:総ランキング数
  • totalResultsReturned:返された値の個数
  • firstResultsPosition:最初のデータが何個目にあたるか(最初=1)

Url リクエストしたURL
StartDate 集計開始日(YYYY-mm-dd)
EndDate 集計終了日(YYYY-mm-dd)
LastModified 更新日(YYYY-mm-dd)
Id リクエスト
category_idに入力した値
RankingData 商品のランキング情報

  • rank:順位(1位から100位まで)
  • vector:前日差(up:上昇/down:下降/stay:維持/new:新規)
  • type:商品/製品(item/product)

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 商品カテゴリ

  • depth:トップからのカテゴリの深さ

Id 現在カテゴリID
ParentId 親カテゴリID
Name カテゴリ名
Children 子カテゴリ群
Child 子カテゴリ

  • sortOrder:ソート順

Id 子カテゴリID
Url 子カテゴリのおすすめページURL
Short 子カテゴリ名
Medium 子カテゴリパス名1
Long 子カテゴリパス名2

※1 商品URLはYahoo!ショッピングのストア商品ページへのリンク、製品URLはYahoo!ショッピング製品ページへのリンクになります。

サンプルレスポンス

以下は、Yahoo!ショッピングの特集ページURLの、リクエストに対するレスポンスです。

エラー

コンテンツマッチランキングWeb APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

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


開発者ブログ

Yahoo! JAPANのスタッフや著名なデベロッパーのブログを紹介しています。新しいサービスのアイデアにお役立てください。

開発者コミュニティ

Yahoo!グループに開発者のためのグループを用意しています。ほかのデベロッパーと交流し、質問やアイデアの共有にお役立てください。

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