Skip to content
PostMCP/ai

get_profile_analytics

Returns a connected profile’s followers, following, post count and — where the network reports it — views or page views, with the raw figures under the platform’s own names. Nothing reads the networks on its own: without refresh the call returns what the last reading stored, free, and says when it was read or that it never has been. With refresh it reads the network now, which costs one credit. LinkedIn only answers for organization pages (unavailable: true on a personal profile); an error mentioning reconnecting means the account was connected before the insights permission existed and its owner must reconnect it. Readings are never added up across profiles — each is a snapshot taken when someone asked.

Access
read
Category
Analytics
Endpoint
POST/api/tools/get_profile_analytics
On this page
  1. Parameters
  2. Example request
  3. Response

Parameters

platform
enumrequired
linkedin · twitter · facebook · instagram · threads · bluesky · youtube
profileId
stringrequired
The profileId from get_connected_accounts.
refresh
boolean
Read the network now (1 credit) instead of returning the stored reading (free).default: false
workspaceId
string
Workspace to act on, from list_workspaces. Omit to use the default workspace on the key.

Example request

curl -X POST "https://api.postmcpai.com/api/tools/get_profile_analytics" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $POSTMCPAI_API_KEY" \
  -d '{
    "platform": "linkedin",
    "profileId": "lin_7741903",
    "refresh": true
  }'

Response

The profile with its reading — normalized summary, raw metrics, the window the flow figures cover, and when it was read — plus what the call cost when refresh was set.

200 · application/json
{
  "platform": "linkedin",
  "profileId": "lin_7741903",
  "username": "postmcp-ai",
  "name": "PostMCP Ai",
  "isOrganization": true,
  "analytics": {
    "fetchedAt": "2026-09-11T07:52:40.000Z",
    "summary": {
      "followers": 1240,
      "following": null,
      "posts": null,
      "views": 8620
    },
    "metrics": {
      "firstDegreeSize": 1240,
      "allPageViews": 8620,
      "allDesktopPageViews": 5310,
      "allMobilePageViews": 3310
    },
    "window": "lifetime",
    "source": "linkedin rest networkSizes + organizationPageStatistics",
    "error": "",
    "unavailable": false
  },
  "note": "",
  "message": "Read linkedin statistics for postmcp-ai.",
  "credits": {
    "charged": 1,
    "remaining": 448
  }
}