LinkedIn Analytics
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!