# Members
The Members endpoint returns posting activity and engagement metrics per workspace member, optionally scoped to a single account and time range. Use it to build leaderboards, performance reviews, and workload reports.
### Requirements
**Authentication:** Bearer API token\
**Scope:** `analytics`\
**Headers:**
* `Authorization: Bearer-API YOUR_API_KEY`
* `Publer-Workspace-Id: YOUR_WORKSPACE_ID`
### Endpoint
#### Get Members Analytics
```http
GET /api/v1/analytics/members
```
#### Description
Retrieves analytics for each workspace member within a required date range. Optionally filter to a specific social account.
#### Query Parameters
Param
Type
Required
Description
from
date (YYYY-MM-DD)
Yes
Start date (inclusive).
to
date (YYYY-MM-DD)
Yes
End date (inclusive).
account_id
string
No
Restrict analytics to one social account. Omit for all workspace accounts.
## Get Analytics Members Data
> Retrieves analytics data for workspace members showing their posting activity and engagement metrics.
```json
{"openapi":"3.1.1","info":{"title":"Publer API","version":"1.0.0"},"tags":[{"name":"Analytics","description":"Endpoints for retrieving analytics data and charts"}],"servers":[{"url":"https://app.publer.com/api/v1"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{},"schemas":{"401ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}},"403ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}}}},"paths":{"/analytics/members":{"get":{"summary":"Get Analytics Members Data","description":"Retrieves analytics data for workspace members showing their posting activity and engagement metrics.","tags":["Analytics"],"parameters":[{"schema":{"type":"string"},"name":"Publer-Workspace-Id","in":"header","description":"ID of the workspace to retrieve members from","required":true},{"schema":{"type":"string","format":"date"},"name":"from","in":"query","description":"Start date for analytics data range (YYYY-MM-DD format). Filters data from this date onwards","required":true},{"schema":{"type":"string","format":"date"},"name":"to","in":"query","description":"End date for analytics data range (YYYY-MM-DD format). Filters data up to this date","required":true},{"schema":{"type":"string"},"name":"account_id","in":"query","description":"Optional account ID to filter analytics data for a specific social media account","required":false}],"responses":{"200":{"description":"Members analytics data with performance metrics","content":{"application/json":{"schema":{"type":"array","description":"List of members with their analytics data","items":{"type":"object","properties":{"engagements":{"type":"integer","description":"Total engagements (likes + comments + shares + post clicks) for the member"},"posts":{"type":"integer","description":"Total number of posts created by the member"},"reach":{"type":"integer","description":"Total reach for the member's posts (only included for supported account types)"},"account_ids":{"type":"array","description":"List of account IDs the member posted to","items":{"type":"string"}},"user":{"type":"object","description":"User information for the member","properties":{"id":{"type":"string","description":"User ID"},"name":{"type":"string","description":"User's display name"},"picture":{"type":"string","description":"URL to user's profile picture"}}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401ErrorResponse"}}}},"403":{"description":"Permission denied - requires analytics access or paying subscription","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403ErrorResponse"}}}}}}}}}
```
Fields:
* `engagements`: Total engagements = likes + comments + shares + post clicks (platform-dependent).
* `posts`: Number of posts created by the member in the range.
* `reach`: Sum of post reach where supported by the platform/account type (may be omitted for unsupported types).
* `account_ids[]`: Accounts the member posted to.
* `user`: Member info `{ id, name, picture }`.
### Notes
* Date range is required; ensure `from` ≤ `to`.
* If `account_id` is omitted, metrics aggregate across all accessible accounts in the workspace.
* `reach` may be missing for networks that don’t expose member-level reach. Handle absent fields gracefully.
* Insights refresh automatically (about every 24 hours). Use “Sync Insights” in the UI to update on demand.
### Related Resources
* [Charts](https://publer.com/docs/analytics/charts) — Discover chart IDs and fetch chart data
* [Post Insights](https://publer.com/docs/analytics/post-insights) — Per‑post performance analytics
* [Hashtag Analysis](https://publer.com/docs/analytics/hashtag-analysis) — Hashtag performance
* [Best Times](https://publer.com/docs/analytics/best-times-to-post) — Suggested posting time slots
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://publer.com/docs/analytics/members.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.