Get LinkedIn creator analytics including engagement, content performance, and audience insights

POST/linkedin/analytics/creator

Get Creator Analytics

Get LinkedIn creator analytics including engagement, content performance, and audience insights. Supports various time ranges and metric types.

Authentication requiredLinkedIn Analytics

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/analytics/creator' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "resultType": "ENGAGEMENT",
      "timeRange": "past_30_days"
    }
  }'

Parameters

No parameters.

Request Body

Field	Type	Required	Description
`accountId`	string	No	LinkedIn account ID (uses default if not provided)
`filters`	object	No	Analytics filter options
`filters.resultType`	string or string[]	No	Type of results: 'AUDIENCES', 'CONTENT', 'ENGAGEMENT', 'GROWTH'
`filters.timeRange`	string or string[]	No	Time range: 'past_7_days', 'past_14_days', 'past_30_days', 'past_90_days', 'past_year', 'custom'
`filters.lineChartType`	string or string[]	No	Chart type: 'daily', 'weekly', 'monthly'
`filters.startDate`	string	No	Start date for custom range (YYYY-MM-DD format, required if timeRange is 'custom')
`filters.endDate`	string	No	End date for custom range (YYYY-MM-DD format, required if timeRange is 'custom')

Example - Engagement Analytics

{
  "filters": {
    "resultType": "ENGAGEMENT",
    "timeRange": "past_30_days"
  }
}

Example - Content Analytics with Line Chart

{
  "filters": {
    "resultType": "CONTENT",
    "timeRange": "past_90_days",
    "lineChartType": "weekly"
  }
}

Example - Custom Date Range

{
  "filters": {
    "resultType": ["ENGAGEMENT", "CONTENT"],
    "timeRange": "custom",
    "startDate": "2024-01-01",
    "endDate": "2024-01-31"
  }
}

Responses

Status	Description
200	Successful response

200 Example

{
  "success": true,
  "accountId": "acc_123456789",
  "profileId": "ACoAAA...",
  "isLineChart": false,
  "filters": {
    "resultType": "ENGAGEMENT",
    "timeRange": "past_30_days"
  },
  "data": {
    "impressions": 15420,
    "engagements": 842,
    "engagementRate": "5.46%",
    "reactions": 612,
    "comments": 145,
    "shares": 85,
    "followers": {
      "total": 5420,
      "gained": 127,
      "lost": 12
    }
  }
}

Result Types

Type	Description
`AUDIENCES`	Audience demographics and insights
`CONTENT`	Content performance metrics
`ENGAGEMENT`	Engagement statistics (reactions, comments, shares)
`GROWTH`	Follower growth trends

Time Ranges

Value	Description
`past_7_days`	Last 7 days
`past_14_days`	Last 14 days
`past_30_days`	Last 30 days
`past_90_days`	Last 90 days
`past_year`	Last 365 days
`custom`	Custom date range (requires startDate and endDate)

Get Creator Analytics

Get Creator Analytics

Code Examples

On this page