読み込み中…
香水の着用記録を、個人が特定できない集計値として多次元でクロス集計できる REST API です。年代×季節、地域×ブランドなど、マーケティングや商品開発に活用できる統計データを取得できます。
発行された API キーを X-API-Key ヘッダに付与してアクセスします。
14 種類のディメンションを組み合わせた集計に対応。件数の少ない区分は伏せて返します。
プランごとの月間呼び出し上限を設定。利用状況は /v1/usage で確認できます。
ベースURL
https://tdzkwmu7wwjghl57pzxmir3hie0strfc.lambda-url.ap-northeast-1.on.aws/すべてのリクエストに API キーが必要です
X-API-Key: <YOUR_API_KEY>/v1/analysis行・列ディメンションを指定してクロス集計結果を取得します。
/v1/dimensions契約プランで利用可能なディメンション・メトリクス一覧を取得します。
/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": ["THIRTIES", "TWENTIES"],
"columns": ["冬", "夏", "春", "秋"],
"cells": {
"THIRTIES": {
"冬": { "count": 60, "percentage": 9.5 },
"夏": { "count": 0, "percentage": 0, "suppressed": true },
"春": { "count": 70, "percentage": 11.1 },
"秋": { "count": 0, "percentage": 0, "suppressed": true }
},
"TWENTIES": {
"冬": { "count": 120, "percentage": 19 },
"夏": { "count": 0, "percentage": 0, "suppressed": true },
"春": { "count": 140, "percentage": 22.2 },
"秋": { "count": 0, "percentage": 0, "suppressed": true }
}
},
"totals": {
"rowTotals": {
"THIRTIES": { "count": 167, "percentage": 26.4 },
"TWENTIES": { "count": 465, "percentage": 73.6 }
},
"columnTotals": {
"冬": { "count": 180, "percentage": 28.5 },
"夏": { "count": 107, "percentage": 16.9 },
"春": { "count": 210, "percentage": 33.2 },
"秋": { "count": 135, "percentage": 21.4 }
},
"grandTotal": { "count": 632, "percentage": 100 }
},
"meta": {
"generatedAt": "2026-01-05T03:12:45.000Z",
"totalRecords": 4810,
"filteredRecords": 632,
"kAnonymityApplied": true,
"suppressedCells": 4,
"query": {
"rowDimension": "ageGroup",
"columnDimension": "season",
"metrics": ["count", "percentage"],
"filters": { "dateRange": { "start": "2025-01-01", "end": "2025-12-31" } },
"options": { "kAnonymityLevel": "standard" }
},
"truncatedSources": []
},
"_api": {
"client": "Example Inc.",
"plan": "STANDARD",
"apiCallsUsed": 41,
"apiCallsLimit": 1000,
"executionTimeMs": 312
}
}ディメンション（14種）
メトリクス
"suppressed": true を付け、count と percentage を 0 にして返します。平均評価・利用者数・よく使われた香水も返しません。meta.filteredRecords も 0 になります。OTHER にまとめます。filters.dateRange）を省略すると、直近 1 年を集計します。API キーの発行、月間呼び出し上限、利用可能ディメンションは契約プランに応じて設定します。 データライセンスのご相談・お見積もりはお気軽にお問い合わせください。