LinkedIn Analytics
warning
Analytics endpoints are not available on the Starter plan. Upgrade to Intermediate, Growth or Business plan to access these endpoints.
LinkedIn analytics endpoints provide insights for your connected LinkedIn accounts. The API auto-detects the account type: if social_network_id contains :person:, it's treated as a personal profile; otherwise, it's treated as an organization page.
1. GET /api/linkedin/overview
Returns account-level metrics with current vs. previous period comparison. Response varies based on account type (organization vs. personal).
Sample Request
curl --location --request GET \
"https://analyze.oneupapp.io/api/linkedin/overview?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"
Sample Response (Organization)
{
"success": true,
"data": {
"metrics": [
{
"key": "posts",
"name": "Posts",
"value_current_period": 18,
"value_last_period": 15,
"percentage_change": "+20.00%"
},
{
"key": "new_followers",
"name": "New Followers",
"value_current_period": 450,
"value_last_period": 380,
"percentage_change": "+18.42%"
},
{
"key": "impressions",
"name": "Impressions",
"value_current_period": 52000,
"value_last_period": 43000,
"percentage_change": "+20.93%"
},
{
"key": "reach",
"name": "Reach",
"value_current_period": 38000,
"value_last_period": 31000,
"percentage_change": "+22.58%"
},
{
"key": "likes",
"name": "Likes",
"value_current_period": 2100,
"value_last_period": 1800,
"percentage_change": "+16.67%"
},
{
"key": "shares",
"name": "Shares",
"value_current_period": 560,
"value_last_period": 480,
"percentage_change": "+16.67%"
},
{
"key": "clicks",
"name": "Clicks",
"value_current_period": 1200,
"value_last_period": 980,
"percentage_change": "+22.45%"
},
{
"key": "comments",
"name": "Comments",
"value_current_period": 340,
"value_last_period": 290,
"percentage_change": "+17.24%"
},
{
"key": "engagement",
"name": "Engagement",
"value_current_period": 3.42,
"value_last_period": 3.18,
"percentage_change": "+7.55%"
}
],
"total_followers": 8900,
"account_type": "organization",
"post_performance": {
"most_engaging": [
{
"id": "li_post_abc",
"commentary": "...",
"permalink_url": "...",
"image_url": "...",
"engagement": "4.21%",
"engagement_rate": "4.21%",
"engagement_rate_raw": 4.21,
"reach": 2800,
"shares": 32
}
],
"least_engaging": [],
"most_reach": [],
"least_reach": [],
"most_shared": [],
"least_shared": []
}
}
}
Sample Response (Personal)
{
"success": true,
"data": {
"metrics": [
{
"key": "new_followers",
"name": "New Followers",
"value_current_period": 120,
"value_last_period": 95,
"percentage_change": "+26.32%"
},
{
"key": "impressions",
"name": "Impressions (Personal)",
"value_current_period": 28000,
"value_last_period": 22000,
"percentage_change": "+27.27%"
},
{
"key": "members_reached",
"name": "Members Reached",
"value_current_period": 18000,
"value_last_period": 14000,
"percentage_change": "+28.57%"
},
{
"key": "reshares",
"name": "Reshares",
"value_current_period": 85,
"value_last_period": 70,
"percentage_change": "+21.43%"
},
{
"key": "reactions",
"name": "Reactions",
"value_current_period": 920,
"value_last_period": 780,
"percentage_change": "+17.95%"
},
{
"key": "comments",
"name": "Comments (Personal)",
"value_current_period": 145,
"value_last_period": 120,
"percentage_change": "+20.83%"
}
],
"total_followers": 3200,
"account_type": "personal",
"post_performance": []
}
}
Organization Metrics
| Key | Name | Description |
|---|---|---|
posts | Posts | Total posts published |
new_followers | New Followers | New followers gained |
impressions | Impressions | Total impressions |
reach | Reach | Unique accounts reached |
likes | Likes | Total likes |
shares | Shares | Total shares |
clicks | Clicks | Total clicks |
comments | Comments | Total comments |
engagement | Engagement | Average engagement rate (float) |
Personal Metrics
| Key | Name | Description |
|---|---|---|
new_followers | New Followers | New followers gained |
impressions | Impressions (Personal) | Total impressions |
members_reached | Members Reached | Unique members reached |
reshares | Reshares | Total reshares |
reactions | Reactions | Total reactions |
comments | Comments (Personal) | Total comments |
Note: engagement is a float (average across posts, multiplied by 100). All other metrics are integers. Personal profiles return post_performance: [].
2. GET /api/linkedin/posts
Returns analytics for posts. Only available for organization accounts. Personal profiles receive a 400 error.
Sample Request
curl --location --request GET \
"https://analyze.oneupapp.io/api/linkedin/posts?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"
Error Response (Personal Account)
{
"success": false,
"message": "Post analytics are not supported for personal LinkedIn profiles due to LinkedIn API limitations."
}
Sample Response (Organization)
{
"success": true,
"data": {
"stats": [
{
"key": "posts",
"name": "Posts",
"value_current_period": 18,
"value_last_period": 15,
"percentage_change": "+20.00%"
},
{
"key": "impressionCount",
"name": "Impressions",
"value_current_period": 52000,
"value_last_period": 43000,
"percentage_change": "+20.93%"
},
{
"key": "uniqueImpressionsCount",
"name": "Reach",
"value_current_period": 38000,
"value_last_period": 31000,
"percentage_change": "+22.58%"
},
{
"key": "likeCount",
"name": "Likes",
"value_current_period": 2100,
"value_last_period": 1800,
"percentage_change": "+16.67%"
},
{
"key": "shareCount",
"name": "Shares",
"value_current_period": 560,
"value_last_period": 480,
"percentage_change": "+16.67%"
},
{
"key": "clickCount",
"name": "Clicks",
"value_current_period": 1200,
"value_last_period": 980,
"percentage_change": "+22.45%"
},
{
"key": "commentCount",
"name": "Comments",
"value_current_period": 340,
"value_last_period": 290,
"percentage_change": "+17.24%"
},
{
"key": "engagement",
"name": "Engagement",
"value_current_period": 3.42,
"value_last_period": 3.18,
"percentage_change": "+7.55%"
}
],
"posts": [
{
"id": "li_post_abc",
"page_id": "li_page_123",
"format": "image",
"commentary": "Excited to announce our new partnership!",
"permalink_url": "https://linkedin.com/posts/li_post_abc",
"image_url": "https://media.licdn.com/...",
"stats": {
"clickCount": 85,
"shareCount": 32,
"engagement": 4.21,
"likeCount": 120,
"impressionCount": 3500,
"commentCount": 18,
"uniqueImpressionsCount": 2800
},
"published_at": "2026-04-20T09:00:00+00:00"
}
]
}
}
Post Stats
| Field | Description |
|---|---|
clickCount | Number of clicks |
shareCount | Number of shares |
engagement | Engagement rate (float) |
likeCount | Number of likes |
impressionCount | Number of impressions |
commentCount | Number of comments |
uniqueImpressionsCount | Unique impressions (reach) |
✅ Result: You have successfully retrieved LinkedIn analytics data!