ショッピング

キーワードランキング

リクエストURL
XML
http://shopping.yahooapis.jp/ShoppingWebService/V1/queryRanking
PHPserialize
http://shopping.yahooapis.jp/ShoppingWebService/V1/php/queryRanking
JSONP
http://shopping.yahooapis.jp/ShoppingWebService/V1/json/queryRanking

キーワードランキングはYahoo!ショッピングで検索されている人気の検索キーワードを取得できるAPIです。人気の検索キーワード以外に、急上昇している検索キーワードも取得できます。

リクエストパラメータ

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

http://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クエリー/秒)
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。(無料)
まずはヘルプページのお問い合わせフォームからご相談ください。