Fanatics
Fanatics 商品検索 API
Fanatics（ファナティクス）のライセンススポーツグッズ（ユニフォーム、帽子、応援グッズ、コレクターズアイテム）を、8つのストア（日本、アメリカ、イギリス、ドイツ、フランス、スペイン、イタリア、カナダ）とアメリカの4つのリーグ公式ストア（NFL Shop、MLB Shop、NHL Shop、MLS Store）でキーワード検索し、ストアの言語と通貨で取得します。性別・年齢、league_id、department_id、filters による各ファセット（チーム、選手、サイズなど）で絞り込み、売れ筋、価格、新着で並べ替えられます。1ページ24・48・72件で、ID、商品名、ブランド、URL、画像、通常価格、セール価格、クリアランス価格、コード適用価格、割引率、価格ラベル、売れ筋バッジ、名入れ可否、出荷予定日と配達予定日、サイトの販売シグナルを返します。さらに 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/jsonquerystringrequired検索キーワード（1〜200文字）。スペルの誤りはサイトが修正します（corrected_query）。
Example: ドジャース
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）。
genderenum<string>性別・年齢層を1つに絞ります。
Example: women
men— メンズ。women— レディース。kids— キッズ。baby— ベビー。
league_idinteger | stringリーグを1つに絞ります。ファセットのID（fanatics.jp では MLB が19）。
Example: 19
department_idinteger | stringカテゴリーを1つに絞ります。ファセットのID（fanatics.jp では「ジャージ」8011、「帽子・キャップ・ニット帽」8008、「Tシャツ」8022）。
Example: 8011
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 で「ドジャース」のジャージを安い順に（現在の価格順）
res = client.fanatics.search(query="ドジャース", country="jp",
department_id=8011, sort="price_low_to_high")["data"]
print(res["total"], "件、一覧の作成時刻", res["data_as_of"])
for item in res["items"]:
print(item["id"], item["title"], item["regular_price"], item["sale_price"], item["clearance_price"])Response