ポンパレモールWEBサービス/ランキングAPI(ショップ別)

説明

ランキングAPI(ショップ別)は、ポンパレモールに公開されている商品のランキング(ショップ別)を取得する機能を提供します。

リクエストURL

http://ranking.api.ponparemall.com/1_0_0/shop/

リクエストパラメーター

パラメーター 項目名 説明 必須
key 認証キー APIを利用するためのキーです。
アカウント登録時に割り当てられるAPIキーを指定してください。
segmentId セグメントID 集計区分
( ws00000a 固定)
shopUrl ショップURL [ショップURL]は商品ページのURLで確認できます。
「http://store.ponparemall.com/[ショップURL]/goods/[商品管理ID]/」
page ページ数 1-999まで指定が可能
(デフォルト:1)
-
limit 取得件数 1-100まで指定が可能
(デフォルト:10)
-
imgSize 画像サイズ 64,80,96,100,144,150,160,192,200,240,300,480,500
(デフォルト:150)
-
format 返却形式 json / jsonp
(デフォルト:jsonp)
-
callback callback関数 jsonpとして出力する際のコールバック関数名
(デフォルト:"callback")
-

サンプルリクエストURL

※ keyの「**********」を取得したAPIキーに置き換えて実行してください。

※ [ショップURL]は商品ページのURLの、下記の箇所が該当します。
    「http://store.ponparemall.com/[ショップURL]/goods/[商品管理ID]/」

レスポンスフィールド

     
Lv フィールド 項目名 備考 出現回数
1 period 期間 weeklyshop1
1 sex 性別 0:すべて、1:男性、2:女性1
1 genreId ジャンルID 1
1 count 検索結果数 1
1 page ページ番号 1
1 first 商品開始番号 1
1 last 商品終了番号 1
1 hits 返却件数 1
1 pageCount 総ページ数 1
1 updTs ランキング更新日時 1
1 itemInfoList 商品情報リスト 1
2     itemId 商品ID (暗号化) N
2     ranking ランキング順位 N
2     genreId ジャンルID N
2     itemManageId 商品管理ID N
2     itemName 商品名 N
2     itemUrl 商品URL N
2     itemImgUrl 商品画像URL N
2     salePriceIncTax 販売価格(税込み) N
2     taxKind 消費税種別 1:税別 , 2:税込 , 3:非課税N
2     pointRate ポイント率 N
2     pointCount ポイント数 N
2     shopId ショップID (暗号化) N
2     shopName ショップ名 N
2     shopTopUrl ショップTOPURL N
2     shopUrl ショップURL N
2     cardAvailableFlg カード有効フラグ 0:カード利用不可能 , 1:カード利用可能N
2     incShippingFlg 送料込フラグ 0:送料別 , 1:送料込N
2     rankingFluctuate ランキング差分 0:new, 1:up, 2:down, 3:stayN
2     evaluateAverage 商品評価平均 N
2     evaluateCount 商品評価数 N
2     codAvailableFlg 代引利用可能フラグ 0:利用不可 , 1:利用可N
2     giftAvailableFlg ギフト利用可能フラグ 0:利用不可 , 1:利用可N
2     prchsStepDispFlg 配送日指定利用可能フラグ 0:利用不可 , 1:利用可N
2     nxdayDlvAvailableFlg 商品翌日配送利用可能フラグ 0:利用不可 , 1:利用可N
2     deferredPymntAvailableFlg 後払い決済利用可能フラグ 0:利用不可 , 1:利用可N
2     carrierPymntAvailableFlg キャリア決済利用可能フラグ 0:利用不可 , 1:利用可N

エラー

ポンパレモールWEBサービスは共通のエラーを返します。
詳しくは、ガイドラインをご覧ください。