LISMOA

広告費（SP/SB/SD の内訳と合計）・インプレッション・クリック・広告経由の注文数と売上・CPC・CPO・ACOS・ROAS を、日次/週次/月次の時系列、またはポートフォリオ別・出品アカウント別の集計で返します（広告「時系列」画面・「ポートフォリオ」画面に相当）。 ROAS は LISMOA の一覧・カードと同じ百分率で返します（例: 広告費に対して売上が 6.5 倍なら 650）。倍率表記ではありません。 商品ごとの広告費と利益の突き合わせは返しません。 時間帯別・広告の曜日別・キャンペーン/広告グループ単位の集計には対応していません。 商品での絞り込みは 1 商品のみ対応します（画面の商品セレクタと同じ仕様）。 時系列は対象期間の期数が上限（daily 100 / weekly 105 / monthly 36）を超えると入力エラーになります。 ポートフォリオ別・出品アカウント別は最大100件で打ち切り、件数は notices に明記します。 金額は整数、ctr / acos / roas 等の率は % の数値です。広告費は正の数（支出額）です。税込/税抜はチームの広告費の表示設定に従います。

get_ad_trends

期間内の売上合計・粗利益・純粗利益・営業利益・注文件数・販売数・セッション数・CVR・カート獲得率を、日次・週次・月次・曜日別・出品アカウント別のいずれかの単位で返します（画面の損益「時系列」「ストア」に相当）。 チームまたは出品アカウント全体の推移と合計を見るためのツールで、商品ごとの内訳や広告の実績は返しません。 期間は既定で直近30日（period または from/to で指定）。行数は集計軸ごとに上限があり（daily 最大100日分 / weekly 最大105週分 / monthly 最大36ヶ月分）、上限を超える期間を指定すると入力エラーになります。 プランのデータ参照期間を超えた要求は切り詰められ、その旨が notices に出ます。 時間帯別（hourly）の集計には対応していません。 金額は整数（meta.currency の通貨）、率は % の数値で返します。 原価・手数料・広告費・コスト合計などのコスト系は画面と同じく負の数（支出）で返します（例: 営業利益 = 売上合計 + コスト合計）。 products で商品を絞り込めるのは group_by が daily / weekly / monthly / weekday のときだけで、store_account（ストア別）と一緒に指定すると入力エラーになります。 weekly / monthly / weekday を指定すると、画面と同じく期間を週（月曜〜日曜）/ 月（月初〜月末）の境界に丸めます（曜日別は今週を含めません）。丸めた場合は meta.period.aligned が true になり notices に出ます。 data.summary（合計）は画面のカードと同じ値で、出品アカウント未指定のときは画面と同じくチーム全体で計算します。

get_sales_trends

接続中の LISMOA アカウント（チームスペース）の状況を返します: チームスペース名・プラン・データ参照期間（何日前まで見られるか）・データ更新間隔・有効な出品アカウント一覧（ID / 名称 / マーケットプレイス / 通貨）・注文データと広告データの最終更新時刻・このサーバーで使えるツール。 ほかのツールで指定する出品アカウント ID と、集計できる期間の範囲・データの鮮度を確認するためのツールです。 売上・商品・注文・広告の数値は返しません。

get_teamspace

注文商品（明細）単位の実績を、注文日・商品・SKU・数量・売上・原価・各種手数料・粗利益で返します（損益「注文」画面に相当）。既定ではキャンセル・返品も含む全ステータスの注文商品が対象で、order_item_statuses でステータスを絞り込めます。 購入者名・住所・メールアドレス等の個人情報は含みません。 注文ごとの明細を見るためのツールで、商品単位の集計（ランキング）は返しません。 既定では新しい注文日から上位 20 件（最大 100 件）を返し、超過分は打ち切って notices に件数を明記します。合計（summary）は打ち切りに関係なく全件ベースの値です。 金額は整数（画面と同じ丸め）です。原価・手数料などのコスト系は画面と同じく負の数（支出）で返します。

list_order_item_metrics

商品（ASIN）ごとの売上・粗利益・営業利益・販売数・セッション・CVR・広告費・ACOS・ROAS を、期間内の実績でランキング形式で返します（損益「商品」画面に相当）。並び替え・件数指定・キーワード（商品名/ASIN/JAN/SKU）や商品タグでの絞り込みに対応します。 商品どうしを比べるためのツールで、注文ごとの明細は返しません。 既定では期間内に売上がない商品も含め上位 20 件（最大 100 件）を返し、超過分は打ち切って notices に件数を明記します。合計（summary）は打ち切りに関係なく全件ベースの値です。 金額は整数（画面と同じ丸め）、cvr / acos / roas 等の率は % の数値です。原価・広告費・コスト合計などのコスト系は画面と同じく負の数（支出）で返します。

list_product_metrics