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

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

get

Retrieves analytics data for workspace members showing their posting activity and engagement metrics.

Authorizations

Bearer

Query parameters

fromstring · dateRequired

Start date for analytics data range (YYYY-MM-DD format). Filters data from this date onwards

Example: {"value":"2024-01-01"}

tostring · dateRequired

End date for analytics data range (YYYY-MM-DD format). Filters data up to this date

Example: {"value":"2024-12-31"}

account_idstringOptional

Optional account ID to filter analytics data for a specific social media account

Example: {"value":"63c675b54e299e9cf2b667ea"}

Header parameters

Publer-Workspace-IdstringRequired

ID of the workspace to retrieve members from

Responses

200

Members analytics data with performance metrics

application/json

List of members with their analytics data

engagementsintegerOptional

Total engagements (likes + comments + shares + post clicks) for the member

Example: 1250

postsintegerOptional

Total number of posts created by the member

Example: 42

reachintegerOptional

Total reach for the member's posts (only included for supported account types)

Example: 15000

account_idsstring[]Optional

List of account IDs the member posted to

Example: ["63c675b54e299e9cf2b667ea","63c675b54e299e9cf2b667eb"]

401

Unauthorized

application/json

403

Permission denied - requires analytics access or paying subscription

application/json

get

/analytics/members

HTTPcURLJavaScriptPython

GET /api/v1/analytics/members?from=2026-02-19&to=2026-02-19 HTTP/1.1
Host: app.publer.com
Publer-Workspace-Id: text
Accept: */*

[
  {
    "engagements": 1250,
    "posts": 42,
    "reach": 15000,
    "account_ids": [
      "63c675b54e299e9cf2b667ea",
      "63c675b54e299e9cf2b667eb"
    ],
    "user": {
      "id": "5b1ec026db27977424e8599e",
      "name": "John Smith",
      "picture": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_mini_magick20250123-28707-otuw0w.png"
    }
  }
]

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 — Discover chart IDs and fetch chart data

• Post Insights — Per‑post performance analytics

• Hashtag Analysis — Hashtag performance

• Best Times — Suggested posting time slots