キーワードランキング

2021/08/31（火）更新
2021年08月31日をもって機能提供を終了させていただきます。

2021/02/26（金）更新
キーワードランキング（v2）への移行をお願いいたします。
詳細はこちら

キーワードランキングはYahoo!ショッピングで検索されている人気の検索キーワードを取得できるAPIです。人気の検索キーワード以外に、急上昇している検索キーワードも取得できます。
※下記ページにあるYahoo!ショッピングの「検索ワードランキング」の結果とは異なります。
https://shopping.yahoo.co.jp/ranking/keyword/

リクエストURL

XML

https://shopping.yahooapis.jp/ShoppingWebService/V1/queryRanking

PHPserialize

https://shopping.yahooapis.jp/ShoppingWebService/V1/php/queryRanking

JSONP

https://shopping.yahooapis.jp/ShoppingWebService/V1/json/queryRanking

リクエストパラメータ

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

パラメータ	値	説明
appid （必須）	string	アプリケーションID。詳細はこちらをご覧ください。
affiliate_type	vc	バリューコマースアフィリエイト（vc）を選択。例：affiliate_type=vc
affiliate_id	string	バリューコマースアフィリエイトIDを入力。
callback	string	JSONPとして出力する際のコールバック関数名を入力するためのパラメータ。UTF-8でエンコードした文字列を入力する。
type	ranking/up	出力するコンテンツタイプを選択する。デフォルトはranking、rankingは検索キーワードランキング、upは急上昇した検索キーワードを返します。
hits	integer	type=rankingのときにのみ有効、デフォルトは20件、最大100件。
offset	integer	type=rankingのときにのみ有効、offset=0のとき1位～20位、offset=20だと21位～40位までの情報を返します。
category_id	integer	指定したカテゴリID以下のキーワードランキング情報を返します　例category_id=2494

サンプルリクエストURL

https://shopping.yahooapis.jp/ShoppingWebService/V1/queryRanking?appid=<あなたのアプリケーションID>&type=ranking

レスポンスフィールド

キーワードランキングAPIのスキーマの記述は、以下になります。

フィールド	説明
/ResultSet	クエリーレスポンスのすべてを含み、次の属性を持ちます。 totalResultsAvailable：総ランキング数 totalResultsReturned：返された値の個数 firstResultsPosition：最初のデータが何個目にあたるか（最初＝1）
/ResultSet/Result/QueryRankingInfo/StartDate	集計開始日（YYYY-mm-dd）
/ResultSet/Result/QueryRankingInfo/EndDate	集計終了日（YYYY-mm-dd）
/ResultSet/Result/QueryRankingInfo/LastModified	更新日（YYYY-mm-dd）
/ResultSet/Result/QueryRankingInfo/type	リクエストtype ranking/up
/ResultSet/Result/QueryRankingData	キーワードランキングの情報です。 rank：現在順位（1位から100位まで） vector：前日差（up：上昇/down：下降/stay：維持/new：新規） prerank：前日順位、前日に圏外およびnewの場合は9999を返す
/ResultSet/Result/QueryRankingData/Query	検索キーワード
/ResultSet/Result/QueryRankingData/Url	Queryの検索結果ページへのURL/アフィリエイトURL（リクエスト時にアフィリエイトを指定した場合）
/ResultSet/Result/QueryRankingData/Relational	関連キーワード情報です。
/ResultSet/Result/QueryRankingData/Relational/RelationalTerm/Query	関連キーワード　1Queryに対して最大4件（Queryに関連するキーワード、例えば　バイオ、vaio、ノートパソコンなど）
/ResultSet/Result/QueryRankingData/Relational/RelationalTerm/Url	関連キーワードの検索結果ページへのURL/アフィリエイトURL（リクエスト時にアフィリエイトを指定した場合）
/ResultSet/Result/Categories/Current	現在カテゴリ情報です。
/ResultSet/Result/Categories/Current/Id	カテゴリID(現在カテゴリ)
/ResultSet/Result/Categories/Current/URL	カテゴリURL(現在カテゴリ)
/ResultSet/Result/Categories/Current/ParentId	カテゴリID(現在カテゴリの親カテゴリID)
/ResultSet/Result/Categories/Current/Title/Short	カテゴリ名(現在カテゴリ)
/ResultSet/Result/Categories/Current/Title/Medium	カテゴリ名(親カテゴリのショートネーム)
/ResultSet/Result/Categories/Current/Title/Long	カテゴリ名(親カテゴリのショートネーム2)
/ResultSet/Result/Categories/Current/Path/Category	カテゴリのパス情報です。 depth ：トップからのカテゴリの深さ
/ResultSet/Result/Categories/Current/Path/Category/Id	カテゴリID(パス)
/ResultSet/Result/Categories/Current/Path/Category/ParentId	カテゴリID(親カテゴリのパス)
/ResultSet/Result/Categories/Current/Path/Category/Title/Name	カテゴリ名(パス)
/ResultSet/Result/Categories/Children/Child	カテゴリ情報です。(子カテゴリ) sortOrder：ソート順
/ResultSet/Result/Categories/Children/Child/Id	カテゴリID(子カテゴリ)
/ResultSet/Result/Categories/Children/Child/URL	URL(子カテゴリ)
/ResultSet/Result/Categories/Children/Child/Title/Short	カテゴリ名(子カテゴリ)
/ResultSet/Result/Categories/Children/Child/Title/Medium	カテゴリ名(子カテゴリのショートネーム)
/ResultSet/Result/Categories/Children/Child/Title/Long	カテゴリ名(子カテゴリのショートネーム2)

サンプルレスポンス

以下は、キーワードランキングのリクエストに対するレスポンスです。

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet xsi:schemaLocation="urn:yahoo:jp:queryRanking http://shopping.yahooapis.jp/ShoppingWebService/V1/queryRanking.xsd" xmlns="urn:yahoo:jp:queryRanking" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsAvailable="100" firstResultPosition="1" totalResultsReturned="20">
  <Result>
    <RankingInfo>
      <StartDate>2012-12-26</StartDate>
      <EndDate>2012-12-26</EndDate>
      <LastModified>2012-12-27</LastModified>
      <Type>ranking</Type>
    </RankingInfo>
    <QueryRankingData rank="1" prerank="9999" vector="new">
      <Query>(秋 秋冬) 2012 新作 -レイン -キッズ</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=(%BD%A9%20%BD%A9%C5%DF)%202012%20%BF%B7%BA%EE%20-%A5%EC%A5%A4%A5%F3%20-%A5%AD%A5%C3%A5%BA&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="2" prerank="2" vector="stay">
      <Query>加湿器 -フィルター</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%B2%C3%BC%BE%B4%EF%20-%A5%D5%A5%A3%A5%EB%A5%BF%A1%BC&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="3" prerank="9999" vector="new">
      <Query>（訳 わけ）</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%A1%CA%CC%F5%20%A4%EF%A4%B1%A1%CB&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="4" prerank="5" vector="up">
      <Query>福袋</Query>
      <Relational>
        <RelationalTerm>
          <Query>福袋 メンズ</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%CA%A1%C2%DE%20%A5%E1%A5%F3%A5%BA</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>福袋 2013</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%CA%A1%C2%DE%202013</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>福袋 ゴルフ</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%CA%A1%C2%DE%20%A5%B4%A5%EB%A5%D5</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%CA%A1%C2%DE&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="5" prerank="4" vector="down">
      <Query>（ファン オイル 電気 ダイソン） -毛布</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%A1%CA%A5%D5%A5%A1%A5%F3%20%A5%AA%A5%A4%A5%EB%20%C5%C5%B5%A4%20%A5%C0%A5%A4%A5%BD%A5%F3%A1%CB%20-%CC%D3%C9%DB&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="6" prerank="3" vector="down">
      <Query>(19 20 21 22 23 24)</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=(19%2020%2021%2022%2023%2024)&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="7" prerank="6" vector="down">
      <Query>しめ縄</Query>
      <Relational>
        <RelationalTerm>
          <Query>お正月 飾り しめ縄</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A4%AA%C0%B5%B7%EE%20%BE%FE%A4%EA%20%A4%B7%A4%E1%C6%EC</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>しめ縄 飾り</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A4%B7%A4%E1%C6%EC%20%BE%FE%A4%EA</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>神棚 しめ縄</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%BF%C0%C3%AA%20%A4%B7%A4%E1%C6%EC</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%A4%B7%A4%E1%C6%EC&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="8" prerank="7" vector="down">
      <Query>あすつく</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%A4%A2%A4%B9%A4%C4%A4%AF&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="9" prerank="11" vector="up">
      <Query>D-BW500</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=D-BW500&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="10" prerank="14" vector="up">
      <Query>佐川急便 荷物問い合わせ</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%BA%B4%C0%EE%B5%DE%CA%D8%20%B2%D9%CA%AA%CC%E4%A4%A4%B9%E7%A4%EF%A4%BB&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="11" prerank="12" vector="up">
      <Query>一体型 VHS HDD</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%B0%EC%C2%CE%B7%BF%20VHS%20HDD&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="12" prerank="8" vector="down">
      <Query>gショック</Query>
      <Relational>
        <RelationalTerm>
          <Query>Gショック ペア</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=G%A5%B7%A5%E7%A5%C3%A5%AF%20%A5%DA%A5%A2</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>Gショック 電波ソーラー</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=G%A5%B7%A5%E7%A5%C3%A5%AF%20%C5%C5%C7%C8%A5%BD%A1%BC%A5%E9%A1%BC</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>カシオ Gショック</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%AB%A5%B7%A5%AA%20G%A5%B7%A5%E7%A5%C3%A5%AF</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=g%A5%B7%A5%E7%A5%C3%A5%AF&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="13" prerank="10" vector="down">
      <Query>セイコー</Query>
      <Relational>
        <RelationalTerm>
          <Query>グランドセイコー</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%B0%A5%E9%A5%F3%A5%C9%A5%BB%A5%A4%A5%B3%A1%BC</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>セイコー腕時計</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%BB%A5%A4%A5%B3%A1%BC%CF%D3%BB%FE%B7%D7</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>セイコー ルキア</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%BB%A5%A4%A5%B3%A1%BC%20%A5%EB%A5%AD%A5%A2</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%A5%BB%A5%A4%A5%B3%A1%BC&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="14" prerank="13" vector="down">
      <Query>iphone5 ケース</Query>
      <Relational>
        <RelationalTerm>
          <Query>iphone5 ケース ブランド</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=iphone5%20%A5%B1%A1%BC%A5%B9%20%A5%D6%A5%E9%A5%F3%A5%C9</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>iphone5 ケース ディズニー</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=iphone5%20%A5%B1%A1%BC%A5%B9%20%A5%C7%A5%A3%A5%BA%A5%CB%A1%BC</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>iphone5 ケース アルミ</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=iphone5%20%A5%B1%A1%BC%A5%B9%20%A5%A2%A5%EB%A5%DF</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=iphone5%20%A5%B1%A1%BC%A5%B9&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="15" prerank="9999" vector="new">
      <Query>トートバッグ</Query>
      <Relational>
        <RelationalTerm>
          <Query>トートバッグ レディース</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%C8%A1%BC%A5%C8%A5%D0%A5%C3%A5%B0%20%A5%EC%A5%C7%A5%A3%A1%BC%A5%B9</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>トートバッグ メンズ</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%C8%A1%BC%A5%C8%A5%D0%A5%C3%A5%B0%20%A5%E1%A5%F3%A5%BA</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>ハリスツイード トートバッグ</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%CF%A5%EA%A5%B9%A5%C4%A5%A4%A1%BC%A5%C9%20%A5%C8%A1%BC%A5%C8%A5%D0%A5%C3%A5%B0</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%A5%C8%A1%BC%A5%C8%A5%D0%A5%C3%A5%B0&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="16" prerank="15" vector="down">
      <Query>-中綿 -ダウンベスト</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=-%C3%E6%CC%CA%20-%A5%C0%A5%A6%A5%F3%A5%D9%A5%B9%A5%C8&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="17" prerank="9" vector="down">
      <Query>G-SHOCK</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=G-SHOCK&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="18" prerank="9999" vector="new">
      <Query>携帯 バッテリー</Query>
      <Relational>
        <RelationalTerm/>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%B7%C8%C2%D3%20%A5%D0%A5%C3%A5%C6%A5%EA%A1%BC&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="19" prerank="17" vector="down">
      <Query>ファー</Query>
      <Relational>
        <RelationalTerm>
          <Query>ファーマフラー</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%D5%A5%A1%A1%BC%A5%DE%A5%D5%A5%E9%A1%BC</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>ファー コート</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%D5%A5%A1%A1%BC%20%A5%B3%A1%BC%A5%C8</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>ファーベスト</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=%A5%D5%A5%A1%A1%BC%A5%D9%A5%B9%A5%C8</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=%A5%D5%A5%A1%A1%BC&amp;cid=1</Url>
    </QueryRankingData>
    <QueryRankingData rank="20" prerank="9999" vector="new">
      <Query>IPOD</Query>
      <Relational>
        <RelationalTerm>
          <Query>ipod touch値段</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=ipod%20touch%C3%CD%C3%CA</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>ipod touch</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=ipod%20touch</Url>
        </RelationalTerm>
        <RelationalTerm>
          <Query>ipod nano</Query>
          <Url>http://shopping.yahoo.co.jp/search?p=ipod%20nano</Url>
        </RelationalTerm>
      </Relational>
      <Url>http://shopping.yahoo.co.jp/search?p=IPOD&amp;cid=1</Url>
    </QueryRankingData>
    <Categories>
      <Current>
        <Url/>
      </Current>
      <Children/>
    </Categories>
  </Result>
</ResultSet>

エラー

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

利用制限

短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）
1日50,000リクエストを超える場合は、アプリケーションIDを追加してご対応ください。

キーワードランキング

リクエストURL

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

エラー

利用制限

利用約款

目次

開発のヒント

サービス一覧