本ガイドは、Flow Reporting APIを利用して店舗データを取得する方法を説明します。
本APIでは以下のデータを取得できます：
来店数（入口別）
属性情報（年代・性別）
売上
取引数
販売点数
本APIのデータは、Flowプラットフォーム上と同一のロジックに基づいており、レポーティング用途としてそのまま利用可能です。
現在利用可能なエンドポイント：/kpis/hourly
時間別の来店数・属性・売上データを取得します。
今後、同一仕様に基づくAPIが追加される可能性があります。
データ構造の変更や新規APIをご希望の場合は、以下までご連絡ください：
[email protected]
データ取得手順：
APIキー取得
https://app.flow-insight.com/general
設定 ＞ 全般 ＞ システム連携 ＞ Flow API
店舗コード取得
Flowより提供
リクエスト送信
POST https://reporting-api.flow-insight.com/rest/kpis/hourly
レスポンス取得およびデータ処理
以上で基本的なデータ連携が可能です。
ヘッダー設定：
Content-Type: application/json
X-Secret-Key: {APIキー}
Accept-Language: ja curl -X POST https://reporting-api.flow-insight.com/rest/kpis/hourly \
-H "Content-Type: application/json" \
-H "X-Secret-Key: {APIキー}" \
-H "Accept-Language: ja" \
-d '{
"date": "2026-04-19",
"storeCodes": ["101", "102"]
}'
{
"data": [
{
"storeCode": "101",
"timestamp": "2026-04-19T11:00:00",
"traffic": {
"001": { "enters": 37, "exits": 47 }
},
"demographics": {
"group_2": 11,
"group_6": 50
},
"sales": 51854,
"transactions": 12,
"itemSold": 22
}
],
"status": 200
}フィールド | 説明 |
|---|---|
storeCode | Flowが管理する店舗の一意ID |
timestamp | 対象時間帯の開始時刻（例：11:00:00 → 11:00〜11:59のデータ） |
traffic | 入口またはセンサー単位の来店・退店数
※「001」「002」などのキーは各入口・センサーの識別子です（Flow側で管理しており、店舗側で名称を把握していない場合があります）。 重要：店舗全体の来店数を確認する場合は、すべての入口（キー）のenters値を合計してください。 |
demographics | 年代・性別別の推定人数
※値が0または未検出の場合、省略されることがあります。 |
sales | 売上金額 |
transactions | 取引件数 |
itemSold | 販売点数 |
店舗コードはFlowが管理する一意の識別子です。
お客様側で変更・新規作成はできません。
各店舗に割り当てられているFlowプラットフォーム上の店舗IDと一致します。
1回のリクエストで最大20店舗まで指定可能
20店舗を超える場合は複数リクエストに分割
制限事項：
「*」による全店舗取得はできません
店舗コードは必ず個別に指定する必要があります
データは店舗稼働中に随時更新されます
最新時間帯のデータは変動する可能性があります
確定値として利用する場合は営業終了後のデータをご利用ください
過去データはすべてAPI経由で取得可能です
本APIは時間別データを提供します。
日次データ：時間別データの合計
月次データ：日次データの合計
集計処理は利用者側で実施します。
時間別データの主な用途：
時間帯別のパフォーマンス分析
ピーク時間の把握
スタッフ配置の最適化
日次データの主な用途：
レポーティングおよびKPI管理
パフォーマンスの集計
月次分析
200：正常
401：認証エラー
確認項目：
APIキー
リクエスト形式
Email: [email protected]
URL: https://app.flow-insight.com/general