For Business

Fragrance Data API

匿名化された香水の着用ログ・投票データを多次元でクロス集計できる REST API です。年代×季節、地域×ブランドなど、マーケティングや商品開発に活用できる統計データを取得できます。

APIキー認証

発行された API キーを X-API-Key ヘッダに付与してアクセスします。

多次元クロス集計

16 種類のディメンションを組み合わせた集計に対応。k-匿名性による保護を適用済みです。

月次レート制限

プランごとの月間呼び出し上限を設定。利用状況は /v1/usage で確認できます。

ベースURL と認証

ベースURL

https://tdzkwmu7wwjghl57pzxmir3hie0strfc.lambda-url.ap-northeast-1.on.aws/

すべてのリクエストに API キーが必要です

X-API-Key: <YOUR_API_KEY>

エンドポイント

POST
/v1/analysis

行・列ディメンションを指定してクロス集計結果を取得します。

GET
/v1/dimensions

契約プランで利用可能なディメンション・メトリクス一覧を取得します。

GET
/v1/usage

当月の API 利用状況(消費数・上限・残り)を取得します。

リクエスト例(クロス集計)

curl -X POST "https://tdzkwmu7wwjghl57pzxmir3hie0strfc.lambda-url.ap-northeast-1.on.aws//v1/analysis" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "rowDimension": "ageGroup",
    "columnDimension": "season",
    "metrics": ["count", "percentage"],
    "filters": {
      "dateRange": { "start": "2025-01-01", "end": "2025-12-31" }
    }
  }'

レスポンス例

{
  "rows": [ { "key": "20代", "values": { "spring": { "count": 1240, "percentage": 18.2 } } } ],
  "_api": {
    "client": "Example Inc.",
    "plan": "STANDARD",
    "apiCallsUsed": 41,
    "apiCallsLimit": 1000,
    "executionTimeMs": 312
  }
}

利用可能なディメンション・メトリクス

ディメンション(16種)

gender · 性別
ageGroup · 年代
prefecture · 都道府県
region · 地方
season · 季節
month ·
year ·
dayOfWeek · 曜日
brand · ブランド
noteFamily · ノートファミリー
concentration · 賦香率
priceRange · 価格帯
scene · シーン
ratingRange · 評価帯
longevityRange · 持続性帯
sillageRange · 拡散性帯

メトリクス

count
percentage
averageRating
uniqueUsers
topPerfumes

APIキーの発行・お見積もり

API キーの発行、月間呼び出し上限、利用可能ディメンションは契約プランに応じて設定します。 データライセンスのご相談・お見積もりはお気軽にお問い合わせください。