キーワードランキング
2021/02/26(金)更新
キーワードランキング(v2)への移行をお願いいたします。
詳細はこちら
キーワードランキングはYahoo!ショッピングで検索されている人気の検索キーワードを取得できるAPIです。
人気の検索キーワード以外に、急上昇している検索キーワードも取得できます。
※下記ページにあるYahoo!ショッピングの「検索ワードランキング」の結果とは異なります。
https://shopping.yahoo.co.jp/ranking/keyword/
リクエストパラメータ
「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?レスポンスフィールド
キーワードランキングAPIのスキーマの記述は、以下になります。
フィールド | 説明 |
---|---|
/ResultSet | クエリーレスポンスのすべてを含み、次の属性を持ちます。
|
/ResultSet/Result/QueryRankingInfo/StartDate | 集計開始日(YYYY-mm- |
/ResultSet/Result/QueryRankingInfo/EndDate | 集計終了日(YYYY-mm- |
/ResultSet/Result/QueryRankingInfo/LastModified | 更新日(YYYY-mm- |
/ResultSet/Result/QueryRankingInfo/type | リクエストtype ranking/up |
/ResultSet/Result/QueryRankingData | キーワードランキングの情報です。
|
/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 | カテゴリのパス情報です。
|
/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 | カテゴリ情報です。(子カテゴリ)
|
/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&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&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&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&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&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)&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&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&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&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&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&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&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&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&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&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&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&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&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&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&cid=1</Url> </QueryRankingData> <Categories> <Current> <Url/> </Current> <Children/> </Categories> </Result> </ResultSet>
エラー
キーワードランキングはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。(1クエリー/秒)
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を緩和させていただきます。(無料)
申請受付は停止中です。
1日50,000リクエストを超える場合は、アプリケーションIDを追加してご対応ください。
利用約款
このAPIに関する利用約款はこちら。