LinkedIn Account
Manage LinkedIn account status, activity history, and warmup status.
LinkedIn Account
Manage your LinkedIn account status, view activity history, and monitor warmup progress. These endpoints help you ensure account health and track engagement activity.
Available Endpoints
Get Account Status →
GET /linkedin/account/status
Get the status of the first available LinkedIn account for the authenticated user. Returns account details including:
- Account info: Name, profile ID, platform
- Status: Current account status and enabled state
- Last used: Timestamp of last account activity
- Token status: Whether authentication tokens are present
Get Account Status by ID →
GET /linkedin/account/{accountId}/status
Get the status of a specific LinkedIn account by its ID. Same response as above but for a specified account.
Get Account Activity History →
GET /linkedin/account/{accountId}/activity
Get the activity history for a LinkedIn account over the last 15 days. Returns:
- Date range: Start and end dates of the analysis period
- Summary: Total comments, reactions, and combined activities
- Daily breakdown: Per-day engagement metrics
- Warmup status: Whether the account is considered "warmed up"
Get Account Warmup Status →
GET /linkedin/account/{accountId}/warmup
Check the warmup status of a LinkedIn account. Warmup is important for new accounts to avoid detection:
- Is warmed up: Boolean indicating warmup completion
- Engagement counts: Comments and reactions in the analysis period
- Tier: Activity tier (high, medium, low)
- Recommended mode: Suggested operation mode based on warmup status
Refresh Warmup Status →
POST /linkedin/account/{accountId}/warmup/refresh
Background refresh of the warmup status for a LinkedIn account. Results are cached for 6 hours:
- Cached status: Returns cached result if available and not expired
- Fresh check: Performs new LinkedIn API calls if cache expired
- Expiry info: When the cached result will expire
Use Cases
- Account monitoring: Track account health and status across multiple LinkedIn accounts
- Warmup tracking: Ensure new accounts are properly warmed up before high-volume operations
- Activity auditing: Review engagement history for compliance or optimization
- Automation safety: Check warmup status before running automated campaigns
