Fanatics
Fanatics セール・クリアランス API
Fanatics のセール一覧を、8つのストアとアメリカの4つのリーグ公式ストアで取得します。セール一覧(コード対象の商品とクリアランスの値下げ品)、clearance(セール一覧の各ページのうちクリアランス価格の商品)、under_25(ストアの通貨で25未満の商品。jp では使えません)から選び、リーグ、チーム、カテゴリー、ブランドで絞り込み、売れ筋、価格、新着で並べ替えられます。1ページ24・48・72件で、通常価格、セール価格、クリアランス価格、コード適用価格、割引率、価格ラベルと、total(最大9,000まで数えます)、IDと件数つきのファセット、data_as_of を返します。価格履歴はないため、セールを追跡するには定期的に取得して価格を保存します。グッズのデータのみです。1リクエスト1クレジットです。
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsontypeenum<string>default:sale取得するセール一覧。
Example: clearance
sale— サイトのセール一覧:コード対象の商品とクリアランスの値下げ品。デフォルト値。clearance— セール一覧の各ページのうちクリアランス価格の商品(total はセール一覧全体の件数)。under_25— ストアの通貨で25未満の商品(サイトの最安価格で判定)。jp では使えず、400になります。
league_idinteger | stringリーグを1つに絞ります(fanatics.jp では MLB が19。NFL 25、NBA 23、NHL 26、College 5)。
Example: 19
team_idinteger | stringチームを1つに絞ります(ファセットのID。fanatics.com では Los Angeles Lakers 3372、Kansas City Chiefs 3433)。
Example: 3433
department_idinteger | stringカテゴリーを1つに絞ります(「帽子・キャップ・ニット帽」8008、「ジャージ」8011)。
Example: 8011
brand_idinteger | stringブランドを1つに絞ります('47 479、Nike 76、New Era 127)。
Example: 76
countryenum<string>default:usFanatics のストア。商品名とファセットのラベルはストアの言語で、価格はストアの通貨で返ります。"jp" は fanatics.jp(日本語、円)です。
Example: jp
us— アメリカ(fanatics.com)、USD。デフォルト値で、site を使えるのはこのストアのみ。gb— イギリス(fanatics.co.uk)、GBP。de— ドイツ(fanatics.de)、EUR。fr— フランス(fanatics.fr)、EUR。es— スペイン(fanatics.es)、EUR。it— イタリア(fanatics.it)、EUR。jp— 日本(fanatics.jp)、JPY。価格帯(price_band、under_25)は使えません。ca— カナダ(fanatics.ca)、CAD。language は en(デフォルト)または fr。
languageenum<string>country が ca のときのみ:en(デフォルト)または fr。fanatics.jp を含むほかのストアは1言語なので不要です。
Example: fr
en— 英語。ca のデフォルト。fr— フランス語(ca)。
siteenum<string>default:fanaticsアメリカのみ(country us):読み取るストア。リーグ公式ストアは fanatics.com と同じ商品IDを使い、商品名は各ストア独自です。カテゴリーやフィルターのIDはストアごとに異なります(ジャージは fanatics.com で8011、NFL Shop で14012)。問い合わせるストアのファセットからIDを取ってください。別のストアのIDはエラーにならず無視されます。us 以外の country と一緒に送ると400になり、"country": "jp" では使えません。
Example: nflshop
fanatics— fanatics.com。デフォルト値。nflshop— NFL Shop(nflshop.com)。mlbshop— MLB Shop(mlbshop.com)。nhlshop— NHL Shop(shop.nhl.com)。mlsstore— MLS Store(mlsstore.com)。
pageinteger結果のページ番号(1から開始)。Fanatics は1つの一覧につき最大9,000商品までしか表示しないため、最終ページは72件なら125、48件なら188、24件なら375です。デフォルトは1。
Example: 2
page_sizeenum<integer>default:721ページあたりの件数。
24— 24件。48— 48件。72— 72件。デフォルト値。
sortenum<string>default:top_sellers一覧の並び順。価格順は現在の価格(price、プロモコード適用前)で並び、コード適用価格では並びません。
top_sellers— Fanatics の売れ筋順。デフォルト値。price_low_to_high— 価格の安い順。price_high_to_low— 価格の高い順。newest— 新着順。
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# fanatics.jp の MLB のクリアランス。取得ごとに保存すれば、それが価格履歴になります
res = client.fanatics.deals(type="clearance", league_id=19, country="jp")["data"]
print(res["count"], "件のクリアランス品(このページのセール品", res["sale_items_on_page"], "件中)")
for item in res["items"]:
print(item["id"], item["title"], item["regular_price"], item["clearance_price"], res["currency"])Response