# 取得會員分析圖表

## Get client statistics

> Retrieve time-series client statistics data with date and count information.\
> \
> Default time range: Last 7 days if startTime and endTime are not provided\
> \
> \*\*Time range limitations:\*\*\
> \- Maximum time range is limited to 1 year (365 days)\
> \- If the time range exceeds 1 year, the system will automatically adjust the startTime to be 365 days before the endTime\
> \- The endTime will remain unchanged to preserve the user's specified end date\
> \
> Platform filtering:\
> \- If platform is not specified, returns data for all platforms\
> \- If platform is specified, returns data only for that platform\
> \
> Supported platforms: line, facebook, instagram, liveChat, whatsapp\
> \
> Response format: Arrays of objects with date and count properties

```json
{"openapi":"3.0.3","info":{"title":"Manta OpenAPI","version":"0.318.0"},"tags":[{"name":"Core","description":"Core OpenAPI functionality for customer management and broadcasting"}],"servers":[{"url":"https://mantago.cc/api","description":"MantaGo Openapi host url"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token for API authentication"}},"schemas":{"ClientStatisticsRequest":{"type":"object","properties":{"secret":{"type":"string","description":"Secret key for API authentication"},"platform":{"type":"string","enum":["line","facebook","instagram","liveChat","whatsapp"],"description":"Platform type for filtering (optional, if not provided returns all platforms)"},"startTime":{"type":"string","format":"date","description":"Start date for statistics range (optional, defaults to 7 days ago if not provided). Note - If the time range exceeds 365 days, startTime will be automatically adjusted to be 365 days before endTime."},"endTime":{"type":"string","format":"date","description":"End date for statistics range (optional, defaults to today if not provided). This date will be preserved even if the time range exceeds 365 days."},"type":{"type":"string","default":"follower","description":"Statistics type","enum":["follower","block","newFollower","interactionFollower"]}},"required":["secret","type"]},"ClientStatisticsResponse":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"clientStatistics":{"type":"object","description":"Time-series client statistics data. Fields returned depend on platform and type parameters:\n- Platform: Determines which platform statistics are included (all platforms if not specified)\n- Type: Filters to specific statistic types (follower, block, newFollower, interactionFollower)\n\nEach array contains objects with date and count properties for the specified time range.","properties":{"lineFollowers":{"type":"array","description":"Daily LINE follower counts (returned when platform='line' or not specified, and type='follower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Date in YYYY-MM-DD format"},"count":{"type":"integer","description":"Follower count for this date"}}}},"lineNewFollowers":{"type":"array","description":"Daily LINE new follower counts (returned when platform='line' or not specified, and type='newFollower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"lineBlocks":{"type":"array","description":"Daily LINE block counts (returned when platform='line' or not specified, and type='block')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"lineInteractionFollowers":{"type":"array","description":"Daily LINE interaction follower counts (returned when platform='line' or not specified, and type='interactionFollower')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"fbFollowers":{"type":"array","description":"Daily Facebook follower counts (returned when platform='facebook' or not specified, and type='follower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"fbNewFollowers":{"type":"array","description":"Daily Facebook new follower counts (returned when platform='facebook' or not specified, and type='newFollower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"fbBlocks":{"type":"array","description":"Daily Facebook block counts (returned when platform='facebook' or not specified, and type='block')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"fbInteractionFollowers":{"type":"array","description":"Daily Facebook interaction follower counts (returned when platform='facebook' or not specified, and type='interactionFollower')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"igFollowers":{"type":"array","description":"Daily Instagram follower counts (returned when platform='instagram' or not specified, and type='follower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"igNewFollowers":{"type":"array","description":"Daily Instagram new follower counts (returned when platform='instagram' or not specified, and type='newFollower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"igInteractionFollowers":{"type":"array","description":"Daily Instagram interaction follower counts (returned when platform='instagram' or not specified, and type='interactionFollower')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"liveChatFollowers":{"type":"array","description":"Daily LiveChat follower counts (returned when platform='liveChat' or not specified, and type='follower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"liveChatNewFollowers":{"type":"array","description":"Daily LiveChat new follower counts (returned when platform='liveChat' or not specified, and type='newFollower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"liveChatInteractionFollowers":{"type":"array","description":"Daily LiveChat interaction follower counts (returned when platform='liveChat' or not specified, and type='interactionFollower')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"whatsappFollowers":{"type":"array","description":"Daily WhatsApp follower counts (returned when platform='whatsapp' or not specified, and type='follower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"whatsappNewFollowers":{"type":"array","description":"Daily WhatsApp new follower counts (returned when platform='whatsapp' or not specified, and type='newFollower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"whatsappInteractionFollowers":{"type":"array","description":"Daily WhatsApp interaction follower counts (returned when platform='whatsapp' or not specified, and type='interactionFollower')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"totalFollowers":{"type":"array","description":"Daily total follower counts across all platforms (only returned when platform is not specified and type='follower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"totalNewFollowers":{"type":"array","description":"Daily total new follower counts across all platforms (only returned when platform is not specified and type='newFollower' or not specified)","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"totalBlocks":{"type":"array","description":"Daily total block counts across all platforms (only returned when platform is not specified and type='block')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}},"totalInteractionFollowers":{"type":"array","description":"Daily total interaction follower counts across all platforms (only returned when platform is not specified and type='interactionFollower')","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"count":{"type":"integer"}}}}}}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errResponse":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"},"botId":{"type":"string"}},"required":["message","code"]}},"required":["success","errResponse"]}},"responses":{"TokenError":{"description":"JWT token is invalid or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"PermissionError":{"description":"Permission denied - insufficient access rights","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"GetOpenApiError":{"description":"OpenAPI configuration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"RateLimitError":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/openapi/clients/statistics":{"post":{"tags":["Core"],"summary":"Get client statistics","description":"Retrieve time-series client statistics data with date and count information.\n\nDefault time range: Last 7 days if startTime and endTime are not provided\n\n**Time range limitations:**\n- Maximum time range is limited to 1 year (365 days)\n- If the time range exceeds 1 year, the system will automatically adjust the startTime to be 365 days before the endTime\n- The endTime will remain unchanged to preserve the user's specified end date\n\nPlatform filtering:\n- If platform is not specified, returns data for all platforms\n- If platform is specified, returns data only for that platform\n\nSupported platforms: line, facebook, instagram, liveChat, whatsapp\n\nResponse format: Arrays of objects with date and count properties","parameters":[{"name":"botId","in":"query","required":true,"schema":{"type":"string"},"description":"The bot ID for the API request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientStatisticsRequest"}}}},"responses":{"200":{"description":"Client statistics data retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientStatisticsResponse"}}}},"401":{"$ref":"#/components/responses/TokenError"},"403":{"$ref":"#/components/responses/PermissionError"},"404":{"$ref":"#/components/responses/GetOpenApiError"},"429":{"$ref":"#/components/responses/RateLimitError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```