リクエストURLXMLhttp://shopping.yahooapis.jp/ShoppingWebService/V1/categoryRankingPHPserializehttp://shopping.yahooapis.jp/ShoppingWebService/V1/php/categoryRankingJSONPhttp://shopping.yahooapis.jp/ShoppingWebService/V1/json/categoryRankingカテゴリランキングはYahoo!ショッピングの商品の売り上げランキング情報を取得することが可能なAPIです。日間の売り上げランキング情報を取得することができます。リクエストパラメータ「RESTリクエストの構築(GET)」をご参照ください。説明appid(必須)stringアプリケーションID。詳細はこちらをご覧ください。outputxml(デフォルト)/php/jsonpXMLのリクエストURL(shopping.yahooapis.jp/ShoppingWebService/V1/categoryRanking)のみ使用可能で、このリクエストを指定すると、各形式でのレスポンスを返すことができます。affiliate_typevcバリューコマースアフィリエイト(vc)を選択。affiliate_idstringバリューコマースアフィリエイトIDを入力。callbackstringJSONPとして出力する際のコールバック関数名を入力する為のパラメータ。UTF-8でエンコードした文字列を入力する。category_idintegerカテゴリIDを指定して使用。デフォルトは、全カテゴリからのランキング。gendermale/female男性(male)、女性(female)の選択。指定なしだと全体のランキングを返す。例:gender=malegenerationinteger取得したい年齢の年代を指定。generation=20periodweekly/daily週間とデイリーでランキングの期間を指定、指定なしの場合は週間を返す。offsetinteger指定した順位を20位毎に表示。offset=1だと1位から20位まで、offset=20だと21位から40位までのランキング情報を返す。typeup売上ランキングの急上昇分、上位5件を返しますサンプルリクエストURLhttp://shopping.yahooapis.jp/ShoppingWebService/V1/categoryRanking?appid=<あなたのアプリケーションID>&category_id=2494≥nder=female≥neration=20サンプルコードカテゴリランキングを使用したサンプルコードです。カテゴリ別売り上げランキングを表示するカテゴリ別売り上げランキングを表示する(モジュール作成用)レスポンスフィールドカテゴリランキングAPIのスキーマの記述は、以下になります。フィールド説明/ResultSetクエリーレスポンスのすべてを含み、次の属性を持ちます。最初のデータが何個目にあたるか(最初=1)/ResultSet/Result/RankingInfo/LastModified更新日(YYYY-mm-dd)/ResultSet/Result/RankingInfo/StartDate集計開始日(YYYY-mm-dd)/ResultSet/Result/RankingInfo/EndDate集計終了日(YYYY-mm-dd)/ResultSet/Result/RankingInfo/CategoryIdリクエストcategory_id/ResultSet/Result/RankingInfo/Genderリクエストgender/ResultSet/Result/RankingInfo/Generationリクエストgenerationに入力した値/ResultSet/Result/RankingInfo/Periodリクエストperiodに入力した値/ResultSet/Result/RankingData商品のランキング情報です。商品/製品(item/product)/ResultSet/Result/RankingData/Name商品名/製品名/ResultSet/Result/RankingData/Url商品URL/製品URL(※1)/ResultSet/Result/RankingData/Image/Id画像ID/ResultSet/Result/RankingData/Image/Small76×76サイズ画像URL/ResultSet/Result/RankingData/Image/Medium146×146サイズの画像URL/ResultSet/Result/RankingData/Review/Rateレビュー平均/ResultSet/Result/RankingData/Review/Countレビュー数/ResultSet/Result/RankingData/Review/UrlレビューページURL/アフィリエイトURL/ResultSet/Result/RankingData/Store/IdストアID/ResultSet/Result/RankingData/StoreNameストア名/ResultSet/Result/RankingData/StoreUrlストアURL/ResultSet/Result/Categoriesカテゴリ情報です。/ResultSet/Result/Categories/Current/IdカテゴリID/ResultSet/Result/Categories/Current/ParentId親カテゴリID/ResultSet/Result/Categories/Current/URLカテゴリURL/ResultSet/Result/Categories/Current/Title/Shortカテゴリ名/ResultSet/Result/Categories/Current/Title/Mediumカテゴリパス名1/ResultSet/Result/Categories/Current/Title/Longカテゴリパス名2/ResultsSet/Result/Categories/Current/Path/Categoryカテゴリのパス情報です。トップからのカテゴリの深さ/ResultsSet/Result/Categories/Current/Path/Category/IdカテゴリID(カテゴリパス用)/ResultsSet/Result/Categories/Current/Path/Category/ParentId親カテゴリID(カテゴリパス用)/ResultsSet/Result/Categories/Current/Path/Category/Title/Nameカテゴリ名(カテゴリパス用)/ResultsSet/Result/Categories/Children子カテゴリのパス情報です。商品URLはYahoo!ショッピングのストア商品ページへのリンク、製品URLはYahoo!ショッピング製品ページへのリンクになります。サンプルレスポンス以下は、総合ランキング情報(カテゴリID指定なし)のリクエストに対するレスポンスです。APIに共通のエラーメッセージおよびコードを返します。できなくなることもございます。(1クエリー/秒)※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を緩和させていただきます。(無料)まずはヘルプページのお問い合わせフォームからご相談ください。