All pages
Powered by GitBook
1 of 1

Loading...

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.

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

Get Analytics Members Data

get

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

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
401

Unauthorized

application/json
403

Permission denied - requires analytics access or paying subscription

application/json
get
GET /api/v1/analytics/members 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"
    }
  }
]