Get followers analytics

Retrieve LinkedIn followers analytics for the authenticated account. Includes engagement metrics, content performance, audience insights, and growth trends. Supports various time ranges and metric filters.

GET/analytics/followers

Authentication requiredAnalytics

Code Examples

curl -X GET 'https://api.connectsafely.ai/linkedin/analytics/followers' \
  -H 'Authorization: Bearer <your_api_key>'

Parameters

Name	In	Required	Type	Description
`accountId`	query	No	string	LinkedIn account ID to use. If not provided, uses the default account.
`resultType`	query	No	string	Type of analytics data to retrieve
`timeRange`	query	No	string	Time range for analytics data
`lineChartType`	query	No	string	Granularity for line chart data
`metricType`	query	No	string	Specific metric to retrieve
`startDate`	query	No	string	Start date for custom range (YYYY-MM-DD)
`endDate`	query	No	string	End date for custom range (YYYY-MM-DD)

Request Body

No request body.

Responses

Status	Description
200	Creator analytics retrieved successfully
400	Bad Request - Invalid filters or missing required fields
401	Unauthorized - Invalid or missing API key
500	Internal Server Error - Failed to get LinkedIn credentials or analytics

200 Response Parameters

Name	Type	Description
`success`	boolean
`accountId`	string	LinkedIn account ID used
`profileId`	string	LinkedIn profile URN
`isLineChart`	boolean	Whether line chart data was requested
`filters`	object	Filters applied to the request
`data`	object	Simplified analytics data

200 Example

{
  "success": true,
  "accountId": "696ce9e780e0483585e4e553",
  "profileId": "ACoAAATPlQ0Bc8wdg-Iy8wZgEDuSdIVWJiE1Aio",
  "isLineChart": false,
  "filters": {
    "resultType": "ENGAGEMENT",
    "timeRange": "past_7_days"
  },
  "data": {
    "summary": {
      "metrics": [
        {
          "title": "Total followers",
          "value": "12,841",
          "change": 1,
          "changeDescription": "vs. prior 7 days",
          "description": "The total number of people that currently follow you."
        }
      ]
    },
    "chart": {
      "title": "New followers",
      "xValueUnit": "day",
      "yValueUnit": "New followers",
      "points": [
        {
          "date": "Feb 18",
          "value": 9,
          "tooltip": "Wednesday, Feb 18, 2026",
          "change": null
        },
        {
          "date": "Feb 19",
          "value": 16,
          "tooltip": "Thursday, Feb 19, 2026",
          "change": 77.8
        },
        {
          "date": "Feb 20",
          "value": 25,
          "tooltip": "Friday, Feb 20, 2026",
          "change": 56.3
        }
      ]
    }
  }
}

400 Response Parameters

Name	Type	Description
`success`	boolean
`error`	object

400 Example

{
  "success": false,
  "error": {
    "issues": [
      {
        "code": "custom",
        "message": "startDate and endDate are required when timeRange is \"custom\"",
        "path": [
          "filters",
          "startDate"
        ]
      }
    ],
    "name": "ZodError"
  }
}

401 Response Parameters

Name	Type	Description
`error`	string

401 Example

{
  "error": "Unauthorized - Invalid credentials"
}

500 Response Parameters

Name	Type	Description
`error`	string

500 Example

{
  "error": "Failed to get creator analytics",
  "success": false
}

Code Examples

On this page