Fanatics
Fanatics 一覧 API
Fanatics の商品一覧を、URLまたはIDで取得します。チーム、選手、リーグのセクション、カテゴリー、ブランド('47、Nike、New Era)、コレクションに対応し、8つのストアとアメリカの4つのリーグ公式ストアで使えます。価格帯(jp を除く)、セール品のみ、性別・年齢、各ファセット(サイズ、カラースタイル、サイン入りなど)で絞り込み、売れ筋、価格、新着で並べ替えられます。ページが表示しているリーグ、チーム、選手、カテゴリー、ブランド、コレクションと、1ページ24・48・72件の商品(通常価格、セール価格、クリアランス価格、コード適用価格)、IDつきのすべてのファセット(チーム、選手(ページに表示される場合。例:レイカーズ)、カテゴリー、ブランド、コレクション、サイズ)を返します。グッズのデータのみです。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/jsonurlstringFanatics の一覧ページのURL:サイトのチーム、選手、リーグ、カテゴリー、ブランド、コレクションのページ、または商品詳細の breadcrumb の url。IDの代わりに使えます。
Example: https://www.fanatics.com/nba/los-angeles-lakers/o-23+t-3372
league_idinteger | stringリーグID(MLB 19、NFL 25、NBA 23、NHL 26、College 5)。リーグだけの指定は商品一覧のないトップページにあたるため、ほかのIDやフィルターと組み合わせてください。
Example: 23
team_idinteger | stringファセットのチームID(fanatics.com では Los Angeles Lakers 3372、Kansas City Chiefs 3433)。
Example: 3372
player_idinteger | string選手のファセット(ページにある場合。例:レイカーズ)または商品詳細の player[] の選手ID(Patrick Mahomes 12072、Aaron Judge 31)。
Example: 12072
department_idinteger | stringカテゴリーID(「帽子・キャップ・ニット帽」8008、「ジャージ」8011)。サブカテゴリーは親-子の形式(8008-8084)。
Example: 8008
brand_idinteger | stringfacets.brands のブランドID('47 479、Nike 76、New Era 127)。
Example: 479
collection_idinteger | stringファセットのコレクションID(City Edition 11552)。
Example: 11552
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)。
on_salebooleanセール品のみ。
Example: true
price_bandenum<string>サイトの価格帯(ストアの通貨)。サイトの最安価格に適用され、プロモコードが適用される場合はコード適用価格が使われるため、一部の商品は価格帯をわずかに上回って表示されます。jp では使えず、送ると400になります(価格帯は25〜150の区切りで、円ではどの商品にも当てはまらないため)。
Example: under_25
under_25— 25未満。25_50— 25〜50。50_100— 50〜100。100_150— 100〜150。over_150— 150超。
genderenum<string>性別・年齢層を1つに絞ります。
Example: women
men— メンズ。women— レディース。kids— キッズ。baby— ベビー。
filtersobject前回のレスポンスのファセットによる絞り込み:{facets[].values[].filter: facets[].values[].value}。1つのフィルターに1つの値、最大12個。例:{"ga": "2"}(fanatics.jp では「レディース」)、{"d": "8011"}(「ジャージ」)、{"es": "2"}(「大きめサイズ」)。値は同じストアのIDを使います。
Example: {"ga": "2"}
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 のジャージ(リーグ19 + カテゴリー8011)
res = client.fanatics.browse(league_id=19, department_id=8011, country="jp")["data"]
print(res["browse"]["league"], res["browse"]["department"], res["total"], "件", res["currency"])
# 一覧のファセット(チーム、選手、ブランドなど)のIDは次の呼び出しに使えます
for f in res["facets"]:
print(f["id"], f["label"], [(v["label"], v["filter"], v["value"]) for v in f["values"][:3]])Response