Creator OSDocs

API resource

LinkedIn

Organization and post analytics, reactions and mentions, and choosing which company page an account posts as.

Get LinkedIn org analytics

GET/v1/analytics/linkedin/org-aggregate-analytics

Works on: LinkedIn

Returns aggregate analytics for a LinkedIn organization page. Parallel to /v1/accounts/{id}/linkedin-aggregate-analytics (which handles personal accounts only). Backed by LinkedIn's organizationalEntityShareStatistics, organizationalEntityFollowerStatistics, and organizationPageStatistics endpoints. Response shape matches /v1/analytics/instagram/account-insights. Max 89 days, defaults to last 30 days. Requires analytics access on your plan. Scope requirements: r_organization_social, r_organization_followers, and r_organization_admin must all be present on the account. Accounts connected before these scopes were included in the OAuth flow will return 412 with a reauth hint.

Query parameters

accountIdstringrequired

The account id for the LinkedIn organization account.

metricsstring

Comma-separated list. Defaults to "impressions,clicks,engagement_rate,organic_followers_gained,followers_gained,followers_lost".

fromDatestring

Start date (YYYY-MM-DD). Defaults to 30 days ago.

toDatestring

End date (YYYY-MM-DD). Defaults to today.

sincestring

Alias of fromDate, kept for existing callers

untilstring

Alias of toDate, kept for existing callers

metricTypestring

No description

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/linkedin/org-aggregate-analytics?accountId=acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "success": true,
  "accountId": "acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W",
  "platform": "linkedin",
  "dateRange": {
    "since": "string",
    "until": "string"
  },
  "metricType": "time_series",
  "breakdown": "string",
  "metrics": {},
  "unavailableMetrics": [
    {
      "metric": "string",
      "reason": "not_enrolled",
      "message": "string"
    }
  ],
  "dataDelay": "Data may be delayed up to 48 hours"
}

Get LinkedIn aggregate stats

GET/v1/accounts/{accountId}/linkedin-aggregate-analytics

Works on: LinkedIn

Returns aggregate analytics across all posts for a LinkedIn personal account. Only includes posts published through Creator OS (LinkedIn API limitation). Org accounts should use /v1/analytics instead. Requires r_member_postAnalytics scope. Saves (POST_SAVE) and sends (POST_SEND) are available for personal accounts; organization pages always return 0 for these two metrics because LinkedIn does not expose them on the organization analytics endpoint.

Path parameters

accountIdstringrequired

The ID of the LinkedIn personal account

Query parameters

aggregationstring

TOTAL (default, lifetime totals) or DAILY (time series). MEMBERS_REACHED not available with DAILY.

fromDatestring

Start date (YYYY-MM-DD). If omitted, returns lifetime analytics.

toDatestring

End date (YYYY-MM-DD, exclusive). Defaults to today if omitted.

startDatestring

Alias of fromDate, kept for existing callers

endDatestring

Alias of toDate, kept for existing callers

metricsstring

Comma-separated metrics: IMPRESSION, MEMBERS_REACHED, REACTION, COMMENT, RESHARE, POST_SAVE, POST_SEND. Omit for all.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W/linkedin-aggregate-analytics" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "success": true
}

Get LinkedIn post stats

GET/v1/accounts/{accountId}/linkedin-post-analytics

Works on: LinkedIn

Returns analytics for a specific LinkedIn post by URN. Works for both personal and organization accounts. Saves and sends are only populated for personal accounts (LinkedIn does not expose these metrics on the organization analytics endpoint).

Path parameters

accountIdstringrequired

The ID of the LinkedIn account

Query parameters

urnstringrequired

The LinkedIn post URN

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W/linkedin-post-analytics?urn=%3Curn%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "accountId": "acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W",
  "platform": "linkedin",
  "accountType": "personal",
  "username": "string",
  "postUrn": "string",
  "analytics": {
    "impressions": 0,
    "reach": 0,
    "likes": 0,
    "comments": 0,
    "shares": 0,
    "saves": 0,
    "sends": 0,
    "clicks": 0,
    "views": 0,
    "engagementRate": 0
  },
  "lastUpdated": "string"
}

Get LinkedIn post reactions

GET/v1/accounts/{accountId}/linkedin-post-reactions

Works on: LinkedIn

Returns individual reactions for a specific LinkedIn post, including reactor profiles (name, headline/job title, profile picture, profile URL, reaction type). Only works for organization/company page accounts. LinkedIn restricts reaction data for personal profiles (r_member_social_feed is a closed permission).

Path parameters

accountIdstringrequired

The ID of the LinkedIn organization account

Query parameters

urnstringrequired

The LinkedIn post URN

limitstring

Maximum number of reactions to return per page

cursorstring

Offset-based pagination start index

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W/linkedin-post-reactions?urn=%3Curn%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "accountId": "acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W",
  "platform": "linkedin",
  "accountType": "organization",
  "username": "string",
  "postUrn": "string",
  "reactions": [
    {
      "reactionType": "string",
      "reactionLabel": "string",
      "reactedAt": "2026-09-25T00:00:00.000Z",
      "from": {
        "urn": "string",
        "name": "string",
        "headline": "string",
        "username": "string",
        "profilePicture": "string",
        "profileUrl": "string"
      }
    }
  ],
  "pagination": {
    "hasMore": true,
    "cursor": "string",
    "total": 0
  },
  "lastUpdated": "string"
}

Resolve LinkedIn mention

GET/v1/accounts/{accountId}/linkedin-mentions

Works on: LinkedIn

Converts a LinkedIn profile or company URL to a URN for @mentions in posts. How to use LinkedIn @mentions (2-step workflow): 1. Call this endpoint with the LinkedIn profile/company URL to get the mention URN and format. 2. Embed the returned mentionFormat (e.g. @Vincent Jong) directly in your post's content field. Example: - Resolve: GET /v1/accounts/{id}/linkedin-mentions?url=linkedin.com/in/vincentjong&displayName=Vincent Jong - Returns: mentionFormat: "@Vincent Jong" - Use in post content: "Great talk with @Vincent Jong today!" Important: The mentions array field in POST /v1/posts is stored for reference only and does NOT trigger @mentions on LinkedIn.

Path parameters

accountIdstringrequired

The LinkedIn account ID

Query parameters

urlstringrequired

LinkedIn profile URL, company URL, or vanity name.

displayNamestring

Exact display name as shown on LinkedIn. Required for person mentions to be clickable. Optional for org mentions.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W/linkedin-mentions?url=%3Curl%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "urn": "urn:li:person:4qj5ox-agD",
  "type": "person",
  "displayName": "Miquel Palet",
  "mentionFormat": "@[Miquel Palet](urn:li:person:4qj5ox-agD)",
  "vanityName": "microsoft",
  "warning": "For clickable person mentions, provide the displayName parameter with the exact name as shown on their LinkedIn profile."
}

List LinkedIn orgs

GET/v1/accounts/{accountId}/linkedin-organizations

Works on: LinkedIn

Returns LinkedIn organizations (company pages) the connected account has admin access to.

Path parameters

accountIdstringrequired

No description

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W/linkedin-organizations" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "organizations": [
    {
      "id": "string",
      "name": "string",
      "vanityName": "string",
      "localizedName": "string"
    }
  ]
}

Switch LinkedIn account type

PUT/v1/accounts/{accountId}/linkedin-organization

Works on: LinkedIn

Switch a LinkedIn account between personal profile and organization (company page) posting.

Path parameters

accountIdstringrequired

No description

Body

accountTypestringrequired

No description - one of: personal, organization

selectedOrganizationobject

No description

curl -X PUT "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Li4Kq8Vw1Nx6Ty3Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6W/linkedin-organization" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountType": "<accountType>"
  }'
Response 200
{
  "message": "string",
  "accountType": "personal",
  "accountName": "string"
}
PreviousYouTubeNextFacebook