posts
Send Post Time Spent Signal
Send time spent signal for a LinkedIn post to track engagement duration
POST
Send Post Time Spent Signal
Send a time spent signal to LinkedIn indicating how long a user spent viewing a specific post. This helps with engagement tracking and analytics.
This endpoint costs 1 credit per request.
Header Parameters
Your API key
Body Parameters
URL of the LinkedIn post to send time spent signal for
Duration in milliseconds that the user spent viewing the post. Must be a positive integer.
Optional start time in milliseconds when the user began viewing the post
LinkedIn authentication cookie obtained from the login/verify process
Country code for proxy selection. Available: (US,UK,FR)
Response
Request status (success/error)
Detailed status message about the time spent signal request
Notes
Duration Requirements
- Duration must be provided in milliseconds
- Must be a positive integer value
- Represents the actual time spent viewing the post
Optional Parameters
duration_start_time
: Can be used to specify when the viewing session began- If provided, must be an integer in milliseconds
Post URL Support
- Supports multiple LinkedIn post URL formats
- Must be a valid LinkedIn post that is accessible with the provided login token
- The API automatically extracts the activity ID from the URL
Error Handling
- Invalid Cookie: Returned when the login token is expired or invalid
- Invalid Post URL: Returned when the post URL format is incorrect or the activity ID cannot be extracted
- Invalid Parameters: Returned when required parameters are missing or have invalid values
- Insufficient Credits: Returned when the API key doesn’t have enough credits
Engagement Tracking
- Signals are sent to LinkedIn’s analytics system
- The signal is associated with the user identity from the login token
Rate Limits
- Consider implementing appropriate delays between requests
Send Post Time Spent Signal