{"openapi":"3.1.0","info":{"title":"綠界大數據 ECPAYDATA Public API","version":"2026-06-09","description":"Public non-sensitive API documentation for 綠界大數據 ECPAYDATA."},"servers":[{"url":"https://0.0.0.0:8080"}],"security":[{"xApiKey":[]}],"components":{"securitySchemes":{"xApiKey":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/public/meta/categories":{"get":{"operationId":"meta_categories","summary":"主分類清單","description":"取得目前可用的主分類名稱，建議作為所有分類型 API 的第一步。","tags":["Meta"],"security":[{"xApiKey":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"categories":{"type":"array","description":"主分類名稱清單。","items":{"type":"string"}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"categories":["3C周邊","不動產建築","健康保健","內容娛樂"]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":1,"x-fixed-usage":true,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.categories[]","type":"string[]","description":"主分類名稱清單。"}]}},"/api/public/meta/sub-categories":{"get":{"operationId":"meta_sub_categories","summary":"子分類清單","description":"取得指定主分類底下的子分類名稱。","tags":["Meta"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"category":{"type":"string","description":"實際使用的主分類名稱。"},"subCategories":{"type":"array","description":"子分類名稱清單。","items":{"type":"string"}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"category":"3C周邊","subCategories":["平板","手機","智慧家庭裝置","相機與攝影設備"]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":1,"x-fixed-usage":true,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.category","type":"string","description":"實際使用的主分類名稱。"},{"name":"data.subCategories[]","type":"string[]","description":"子分類名稱清單。"}]}},"/api/public/trends/overview":{"get":{"operationId":"trends_overview","summary":"Overview 趨勢","description":"取得整體週度交易趨勢，適合用於首頁總覽面積圖。","tags":["Overview"],"security":[{"xApiKey":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"granularity":{"type":"string","description":"趨勢粒度；週聚合可用時為 week，尚未建立或刷新時暫回退為 month。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"trend":{"type":"array","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。","items":{"type":"object","properties":{"month":{"type":"string","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。"},"week_start":{"type":"string","description":"週度資料的完整週起始日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},"week_end":{"type":"string","description":"週度資料的完整週結束日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},"total_amount":{"type":"number","description":"該週交易金額。"},"trade_count":{"type":"number","description":"該週交易筆數。"},"avg_amount":{"type":"number","description":"該週平均客單價。"}},"additionalProperties":false}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"overview","granularity":"week","start":"2025-01-01","end":"2025-12-26","trend":[{"month":"01/06-01/12","week_start":"2025-01-06","week_end":"2025-01-12","total_amount":1514345291,"trade_count":464376,"avg_amount":3261},{"month":"01/13-01/19","week_start":"2025-01-13","week_end":"2025-01-19","total_amount":1490029693,"trade_count":444618,"avg_amount":3351}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":40,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.granularity","type":"string","description":"趨勢粒度；週聚合可用時為 week，尚未建立或刷新時暫回退為 month。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.trend[].month","type":"string","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。"},{"name":"data.trend[].week_start","type":"string","description":"週度資料的完整週起始日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},{"name":"data.trend[].week_end","type":"string","description":"週度資料的完整週結束日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},{"name":"data.trend[].total_amount","type":"number","description":"該週交易金額。"},{"name":"data.trend[].trade_count","type":"number","description":"該週交易筆數。"},{"name":"data.trend[].avg_amount","type":"number","description":"該週平均客單價。"}]}},"/api/public/overview/ranking":{"get":{"operationId":"overview_ranking","summary":"Overview 排行","description":"取得首頁主分類交易排行，包含金額、筆數、客單與熱門子分類。","tags":["Overview"],"security":[{"xApiKey":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"items":{"type":"array","description":"分類或付款方式名稱。","items":{"type":"object","properties":{"name":{"type":"string","description":"分類或付款方式名稱。"},"total_amount":{"type":"number","description":"交易金額。"},"trade_count":{"type":"number","description":"交易筆數。"},"avg_amount":{"type":"number","description":"平均客單價。"},"producttypename":{"type":"string","description":"主分類名稱。"},"top_subs":{"type":"array","description":"該主分類熱門子分類。","items":{"type":"string"}}},"additionalProperties":false}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"overview-ranking","start":"2025-01-01","end":"2025-12-26","items":[{"producttypename":"金融服務","total_amount":15854722007,"trade_count":4090836,"avg_amount":3876,"top_subs":["支付與金流服務","理財與投資服務","保險相關服務"]}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":30,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.items[].name","type":"string","description":"分類或付款方式名稱。"},{"name":"data.items[].total_amount","type":"number","description":"交易金額。"},{"name":"data.items[].trade_count","type":"number","description":"交易筆數。"},{"name":"data.items[].avg_amount","type":"number","description":"平均客單價。"},{"name":"data.items[].producttypename","type":"string","description":"主分類名稱。"},{"name":"data.items[].top_subs[]","type":"string[]","description":"該主分類熱門子分類。"}]}},"/api/public/overview/growth":{"get":{"operationId":"overview_growth","summary":"Overview 成長率","description":"取得主分類金額與筆數成長率排行。","tags":["Overview"],"security":[{"xApiKey":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"固定為 overview-growth。"},"items":{"type":"array","description":"主分類名稱。","items":{"type":"object","properties":{"producttypename":{"type":"string","description":"主分類名稱。"},"current_amount":{"type":"number","description":"目前區間交易金額。"},"previous_amount":{"type":"number","description":"前一比較區間交易金額。"},"growth_rate":{"type":"number","description":"金額成長率。"},"current_count":{"type":"number","description":"目前區間交易筆數。"},"count_growth_rate":{"type":"number","description":"筆數成長率。"}},"additionalProperties":false}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"overview-growth","start":"2025-01-01","end":"2025-12-26","items":[{"producttypename":"彩妝保養","current_amount":3238346622,"previous_amount":2615150862,"growth_rate":23.8,"current_count":357889,"previous_count":359045,"count_growth_rate":-0.3}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":40,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"固定為 overview-growth。"},{"name":"data.items[].producttypename","type":"string","description":"主分類名稱。"},{"name":"data.items[].current_amount","type":"number","description":"目前區間交易金額。"},{"name":"data.items[].previous_amount","type":"number","description":"前一比較區間交易金額。"},{"name":"data.items[].growth_rate","type":"number","description":"金額成長率。"},{"name":"data.items[].current_count","type":"number","description":"目前區間交易筆數。"},{"name":"data.items[].count_growth_rate","type":"number","description":"筆數成長率。"}]}},"/api/public/overview/payment":{"get":{"operationId":"overview_payment","summary":"Overview 付款方式","description":"取得首頁付款方式分佈。","tags":["Overview"],"security":[{"xApiKey":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"items":{"type":"array","description":"付款方式名稱。","items":{"type":"object","properties":{"name":{"type":"string","description":"付款方式名稱。"},"count":{"type":"number","description":"交易筆數。"},"percent":{"type":"string","description":"該付款方式佔比。"}},"additionalProperties":false}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"overview-payment","start":"2025-01-01","end":"2025-12-26","items":[{"name":"信用卡","count":1262379,"percent":"66.8%"},{"name":"ATM 虛擬帳號","count":245834,"percent":"13.0%"},{"name":"超商代碼","count":170524,"percent":"9.0%"}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":20,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.items[].name","type":"string","description":"付款方式名稱。"},{"name":"data.items[].count","type":"number","description":"交易筆數。"},{"name":"data.items[].percent","type":"string","description":"該付款方式佔比。"}]}},"/api/public/trends/market":{"get":{"operationId":"trends_market","summary":"Market 趨勢","description":"取得主分類市場的週度交易趨勢。","tags":["Market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"start","in":"query","required":false,"description":"查詢起始日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-07-01"},{"name":"end","in":"query","required":false,"description":"查詢結束日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-12-26"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"granularity":{"type":"string","description":"趨勢粒度；週聚合可用時為 week，尚未建立或刷新時暫回退為 month。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"trend":{"type":"array","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。","items":{"type":"object","properties":{"month":{"type":"string","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。"},"week_start":{"type":"string","description":"週度資料的完整週起始日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},"week_end":{"type":"string","description":"週度資料的完整週結束日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},"total_amount":{"type":"number","description":"該週交易金額。"},"trade_count":{"type":"number","description":"該週交易筆數。"},"avg_amount":{"type":"number","description":"該週平均客單價。"}},"additionalProperties":false}},"category":{"type":"string","description":"實際使用的主分類名稱。"}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"market","granularity":"week","category":"3C周邊","start":"2025-07-01","end":"2025-12-26","trend":[{"month":"07/07-07/13","week_start":"2025-07-07","week_end":"2025-07-13","total_amount":33183836,"trade_count":8743,"avg_amount":3795},{"month":"07/14-07/20","week_start":"2025-07-14","week_end":"2025-07-20","total_amount":40292866,"trade_count":9331,"avg_amount":4319}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":50,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.granularity","type":"string","description":"趨勢粒度；週聚合可用時為 week，尚未建立或刷新時暫回退為 month。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.trend[].month","type":"string","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。"},{"name":"data.trend[].week_start","type":"string","description":"週度資料的完整週起始日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},{"name":"data.trend[].week_end","type":"string","description":"週度資料的完整週結束日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},{"name":"data.trend[].total_amount","type":"number","description":"該週交易金額。"},{"name":"data.trend[].trade_count","type":"number","description":"該週交易筆數。"},{"name":"data.trend[].avg_amount","type":"number","description":"該週平均客單價。"},{"name":"data.category","type":"string","description":"實際使用的主分類名稱。"}]}},"/api/public/market/sub-ranking":{"get":{"operationId":"market_sub_ranking","summary":"Market 子分類排行","description":"取得指定主分類底下的子分類交易排行。","tags":["Market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"start","in":"query","required":false,"description":"查詢起始日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-07-01"},{"name":"end","in":"query","required":false,"description":"查詢結束日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-12-26"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"items":{"type":"array","description":"分類或付款方式名稱。","items":{"type":"object","properties":{"name":{"type":"string","description":"分類或付款方式名稱。"},"total_amount":{"type":"number","description":"交易金額。"},"trade_count":{"type":"number","description":"交易筆數。"},"avg_amount":{"type":"number","description":"平均客單價。"}},"additionalProperties":false}},"category":{"type":"string","description":"實際使用的主分類名稱。"}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"market-sub-ranking","category":"3C周邊","start":"2025-07-01","end":"2025-12-26","items":[{"name":"電腦周邊設備","total_amount":506720263,"trade_count":120008,"avg_amount":4222},{"name":"手機","total_amount":221828289,"trade_count":85593,"avg_amount":2592},{"name":"筆電與桌機","total_amount":78126816,"trade_count":11086,"avg_amount":7047}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":35,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.items[].name","type":"string","description":"分類或付款方式名稱。"},{"name":"data.items[].total_amount","type":"number","description":"交易金額。"},{"name":"data.items[].trade_count","type":"number","description":"交易筆數。"},{"name":"data.items[].avg_amount","type":"number","description":"平均客單價。"},{"name":"data.category","type":"string","description":"實際使用的主分類名稱。"}]}},"/api/public/market/payment":{"get":{"operationId":"market_payment","summary":"Market 付款方式","description":"取得指定主分類的付款方式分佈。","tags":["Market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"start","in":"query","required":false,"description":"查詢起始日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-07-01"},{"name":"end","in":"query","required":false,"description":"查詢結束日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-12-26"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"items":{"type":"array","description":"付款方式名稱。","items":{"type":"object","properties":{"name":{"type":"string","description":"付款方式名稱。"},"count":{"type":"number","description":"交易筆數。"},"percent":{"type":"string","description":"該付款方式佔比。"}},"additionalProperties":false}},"category":{"type":"string","description":"實際使用的主分類名稱。"}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"market-payment","category":"3C周邊","start":"2025-07-01","end":"2025-12-26","items":[{"name":"信用卡","count":148428,"percent":"63.9%"},{"name":"超商代碼","count":35188,"percent":"15.1%"},{"name":"ATM 虛擬帳號","count":27895,"percent":"12.0%"}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":25,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.items[].name","type":"string","description":"付款方式名稱。"},{"name":"data.items[].count","type":"number","description":"交易筆數。"},{"name":"data.items[].percent","type":"string","description":"該付款方式佔比。"},{"name":"data.category","type":"string","description":"實際使用的主分類名稱。"}]}},"/api/public/market/focus":{"get":{"operationId":"market_focus","summary":"Market 數據焦點","description":"取得指定主分類的人維度與交易焦點指標。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。","tags":["Market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"start","in":"query","required":false,"description":"查詢起始日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-07-01"},{"name":"end","in":"query","required":false,"description":"查詢結束日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-12-26"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"category":{"type":"string","description":"主分類名稱。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"focus":{"type":"object","description":"目前區間的人維度與交易焦點指標。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。","additionalProperties":true},"prevFocus":{"type":["object","null"],"description":"前一比較區間的人維度與交易焦點指標；若該 endpoint 未提供比較期則為 null。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。","additionalProperties":true}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"market-focus","category":"3C周邊","start":"2025-07-01","end":"2025-12-26","focus":{"tradeCount":232406,"totalAmount":909019948,"avgAmount":3911,"merchantCount":4011,"audienceCount":52589,"frequency":4.42,"arpu":17285},"prevFocus":{"tradeCount":286402,"totalAmount":947358328,"avgAmount":3308,"merchantCount":3851,"audienceCount":51940,"frequency":5.51,"arpu":18239}}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":45,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.category","type":"string","description":"主分類名稱。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.focus","type":"object","description":"目前區間的人維度與交易焦點指標。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。"},{"name":"data.prevFocus","type":"object|null","description":"前一比較區間的人維度與交易焦點指標；若該 endpoint 未提供比較期則為 null。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。"}]}},"/api/public/trends/sub-market":{"get":{"operationId":"trends_sub_market","summary":"Sub-market 趨勢","description":"取得指定子分類的週度交易趨勢。","tags":["Sub-market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"sub","in":"query","required":false,"description":"子分類名稱。未提供或無效時會使用系統預設子分類。","schema":{"type":"string"},"example":"精華液"},{"name":"start","in":"query","required":false,"description":"查詢起始日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-07-01"},{"name":"end","in":"query","required":false,"description":"查詢結束日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-12-26"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"granularity":{"type":"string","description":"趨勢粒度；週聚合可用時為 week，尚未建立或刷新時暫回退為 month。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"trend":{"type":"array","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。","items":{"type":"object","properties":{"month":{"type":"string","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。"},"week_start":{"type":"string","description":"週度資料的完整週起始日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},"week_end":{"type":"string","description":"週度資料的完整週結束日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},"total_amount":{"type":"number","description":"該週交易金額。"},"trade_count":{"type":"number","description":"該週交易筆數。"},"avg_amount":{"type":"number","description":"該週平均客單價。"}},"additionalProperties":false}},"category":{"type":"string","description":"實際使用的主分類名稱。"},"subCategory":{"type":"string","description":"實際使用的子分類名稱。"}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"sub-market","granularity":"week","category":"3C周邊","subCategory":"平板","start":"2025-07-01","end":"2025-12-26","trend":[{"month":"07/07-07/13","week_start":"2025-07-07","week_end":"2025-07-13","total_amount":3626635,"trade_count":460,"avg_amount":7888},{"month":"07/14-07/20","week_start":"2025-07-14","week_end":"2025-07-20","total_amount":3421084,"trade_count":444,"avg_amount":7709}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":60,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.granularity","type":"string","description":"趨勢粒度；週聚合可用時為 week，尚未建立或刷新時暫回退為 month。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.trend[].month","type":"string","description":"週區間標籤，格式為 MM/DD-MM/DD；欄位名保留為 month 以相容既有客戶端。"},{"name":"data.trend[].week_start","type":"string","description":"週度資料的完整週起始日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},{"name":"data.trend[].week_end","type":"string","description":"週度資料的完整週結束日，格式為 YYYY-MM-DD；月度 fallback 不提供。"},{"name":"data.trend[].total_amount","type":"number","description":"該週交易金額。"},{"name":"data.trend[].trade_count","type":"number","description":"該週交易筆數。"},{"name":"data.trend[].avg_amount","type":"number","description":"該週平均客單價。"},{"name":"data.category","type":"string","description":"實際使用的主分類名稱。"},{"name":"data.subCategory","type":"string","description":"實際使用的子分類名稱。"}]}},"/api/public/sub-market/focus":{"get":{"operationId":"sub_market_focus","summary":"Sub-market 數據焦點","description":"取得指定子分類的人維度與交易焦點指標。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。","tags":["Sub-market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"sub","in":"query","required":false,"description":"子分類名稱。未提供或無效時會使用系統預設子分類。","schema":{"type":"string"},"example":"精華液"},{"name":"start","in":"query","required":false,"description":"查詢起始日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-07-01"},{"name":"end","in":"query","required":false,"description":"查詢結束日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-12-26"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"資料類型識別值。"},"category":{"type":"string","description":"主分類名稱。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"focus":{"type":"object","description":"目前區間的人維度與交易焦點指標。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。","additionalProperties":true},"prevFocus":{"type":["object","null"],"description":"前一比較區間的人維度與交易焦點指標；若該 endpoint 未提供比較期則為 null。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。","additionalProperties":true},"subCategory":{"type":"string","description":"實際使用的子分類名稱。"}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"sub-market-focus","category":"3C周邊","subCategory":"平板","start":"2025-07-01","end":"2025-12-26","focus":{"tradeCount":9880,"totalAmount":76501807,"avgAmount":7743,"merchantCount":25,"audienceCount":747,"frequency":13.23,"arpu":102412},"prevFocus":null}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":65,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"資料類型識別值。"},{"name":"data.category","type":"string","description":"主分類名稱。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.focus","type":"object","description":"目前區間的人維度與交易焦點指標。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。"},{"name":"data.prevFocus","type":"object|null","description":"前一比較區間的人維度與交易焦點指標；若該 endpoint 未提供比較期則為 null。其中 tradeCount、totalAmount、avgAmount 為目前查詢區間的全付款方式交易口徑；audienceCount、frequency、arpu 僅統計信用卡、信用卡分期與銀聯且具會員識別的訂單。"},{"name":"data.subCategory","type":"string","description":"實際使用的子分類名稱。"}]}},"/api/public/sub-market/tags":{"get":{"operationId":"sub_market_tags","summary":"Sub-market 常見商品標籤","description":"取得指定子分類在指定期間內有成交商品的常見標籤 Top 10 與覆蓋率；標籤可重疊，百分比不一定加總為 100%。","tags":["Sub-market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"sub","in":"query","required":false,"description":"子分類名稱。未提供或無效時會使用系統預設子分類。","schema":{"type":"string"},"example":"精華液"},{"name":"start","in":"query","required":false,"description":"查詢起始日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-07-01"},{"name":"end","in":"query","required":false,"description":"查詢結束日期，格式為 YYYY-MM-DD。","schema":{"type":"string"},"example":"2025-12-26"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"固定為 sub-market-tags。"},"category":{"type":"string","description":"實際使用的主分類名稱。"},"subCategory":{"type":"string","description":"實際使用的子分類名稱。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"items":{"type":"array","description":"TAG 維度名稱，例如 類型、功能。","items":{"type":"object","properties":{"key":{"type":"string","description":"TAG 維度名稱，例如 類型、功能。"},"value":{"type":"string","description":"TAG 值。"},"count":{"type":"number","description":"指定期間內有成交，且帶有此標籤的商品數。"},"percent":{"type":"number","description":"指定期間內有成交且具任一標籤商品中的覆蓋率；標籤可重疊，因此不一定加總為 100。"}},"additionalProperties":false}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"sub-market-tags","category":"3C周邊","subCategory":"平板","start":"2025-07-01","end":"2025-12-26","items":[{"key":"保護殼","value":"15.6吋","count":1280,"percent":15.6},{"key":"作業系統","value":"平板","count":1140,"percent":14}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":100,"x-fixed-usage":false,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"固定為 sub-market-tags。"},{"name":"data.category","type":"string","description":"實際使用的主分類名稱。"},{"name":"data.subCategory","type":"string","description":"實際使用的子分類名稱。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.items[].key","type":"string","description":"TAG 維度名稱，例如 類型、功能。"},{"name":"data.items[].value","type":"string","description":"TAG 值。"},{"name":"data.items[].count","type":"number","description":"指定期間內有成交，且帶有此標籤的商品數。"},{"name":"data.items[].percent","type":"number","description":"指定期間內有成交且具任一標籤商品中的覆蓋率；標籤可重疊，因此不一定加總為 100。"}]}},"/api/public/sub-market/related-purchases":{"get":{"operationId":"sub_market_related_purchases","summary":"Sub-market 相關購買關聯","description":"取得買過指定子分類的消費者，還買了哪些其他子分類 Top 5；此端點使用目前預設資料區間快取，不支援自訂日期即時計算。","tags":["Sub-market"],"security":[{"xApiKey":[]}],"parameters":[{"name":"category","in":"query","required":false,"description":"主分類名稱。未提供或無效時會使用系統預設主分類。","schema":{"type":"string"},"example":"美妝保養"},{"name":"sub","in":"query","required":false,"description":"子分類名稱。未提供或無效時會使用系統預設子分類。","schema":{"type":"string"},"example":"精華液"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","const":200,"description":"固定為 200。"},"data":{"type":"object","properties":{"type":{"type":"string","description":"固定為 sub-market-related-purchases。"},"category":{"type":"string","description":"實際使用的主分類名稱。"},"subCategory":{"type":"string","description":"實際使用的子分類名稱。"},"start":{"type":"string","description":"回應資料涵蓋的起始日期。"},"end":{"type":"string","description":"回應資料涵蓋的結束日期。"},"items":{"type":"array","description":"關聯購買的主分類名稱。","items":{"type":"object","properties":{"category":{"type":"string","description":"關聯購買的主分類名稱。"},"subCategory":{"type":"string","description":"關聯購買的子分類名稱。"},"memberCount":{"type":"number","description":"符合關聯條件的消費者人數。"},"percent":{"type":"number","description":"Top 清單內的佔比百分比數值。"}},"additionalProperties":false}}},"additionalProperties":false}},"required":["code","data"],"additionalProperties":false},"examples":{"success":{"summary":"成功回應","value":{"code":200,"data":{"type":"sub-market-related-purchases","category":"3C周邊","subCategory":"平板","start":"2025-07-01","end":"2025-12-26","items":[{"category":"成人用品","subCategory":"成人用品","memberCount":1280,"percent":23.9},{"category":"皮膚管理療程","subCategory":"皮膚管理療程","memberCount":1140,"percent":23.9}]}}}}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Missing_API_key":{"summary":"Missing API key","description":"未提供 `x-api-key` header。","value":{"code":401,"msg":"Missing API key"}},"Invalid_API_key":{"summary":"Invalid API key","description":"API Key 不存在、格式錯誤或已被刪除。","value":{"code":401,"msg":"Invalid API key"}}}}}},"402":{"description":"Insufficient API points","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API":{"summary":"API 點數餘額不足","description":"API 點數不足，需儲值或聯絡管理員。","value":{"code":402,"msg":"API 點數餘額不足","data":{"balance":0,"required":50}}}}}}},"403":{"description":"Inactive API key or inactive owner","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"API_key_is_inactive":{"summary":"API key is inactive","description":"API Key 已停用。","value":{"code":403,"msg":"API key is inactive"}},"API_key_owner_is_inactive":{"summary":"API key owner is inactive","description":"API Key 所屬帳號已停用。","value":{"code":403,"msg":"API key owner is inactive"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP status code mirrored in the response body."},"msg":{"type":"string","description":"Error message."},"data":{"type":"object","description":"Optional error metadata.","additionalProperties":true}},"required":["code","msg"],"additionalProperties":false},"examples":{"Internal_server_error":{"summary":"Internal server error","description":"系統錯誤，請稍後重試或聯絡支援。","value":{"code":500,"msg":"Internal server error"}}}}}}},"x-usage-points":60,"x-fixed-usage":true,"x-response-summary":[{"name":"code","type":"number","description":"固定為 200。"},{"name":"data.type","type":"string","description":"固定為 sub-market-related-purchases。"},{"name":"data.category","type":"string","description":"實際使用的主分類名稱。"},{"name":"data.subCategory","type":"string","description":"實際使用的子分類名稱。"},{"name":"data.start","type":"string","description":"回應資料涵蓋的起始日期。"},{"name":"data.end","type":"string","description":"回應資料涵蓋的結束日期。"},{"name":"data.items[].category","type":"string","description":"關聯購買的主分類名稱。"},{"name":"data.items[].subCategory","type":"string","description":"關聯購買的子分類名稱。"},{"name":"data.items[].memberCount","type":"number","description":"符合關聯條件的消費者人數。"},{"name":"data.items[].percent","type":"number","description":"Top 清單內的佔比百分比數值。"}]}}}}