Skip to main content

People

Monitor person updates

The Linked API allows you to monitor updates from a person on LinkedIn programmatically, including new posts, changes in experience, and other relevant activities. Below is an example of how to set up monitoring for person updates using a GET request.

Endpoint

GET /v1/people/updates

Parameters

  • url (required, string): The LinkedIn profile URL of the person to monitor for updates.
  • updateType (optional, string): Specify the type of updates you want to monitor. Accepted values:posts: Monitor new posts by the person.experience: Monitor changes in the person's work experience.position: Monitor updates in the person's job title or position.country: Monitor updates in the person's location or country.skills: Monitor updates in the person's skills.education: Monitor updates in the person's education.all: Monitor all types of updates (default).
  • frequency (optional, string): The frequency of updates in minutes. Default is 60 minutes.

Example

curl -X GET "https://api.linkedapi.io/v1/people/updates?updateType=all&frequency=30" \
-H "Content-Type: application/json" \
-H "x-api-token: your-api-token-here" \
-H "account-token: your-account-token-here" \
-d '{
  "url": "https://www.linkedin.com/in/johndoe/"
}'

Response

{
  "data": {
    "updates": [
      {
        "type": "post",
        "postId": "987654321",
        "content": "Excited to share that I’ll be attending the next AI summit!",
        "timestamp": "2024-09-21T11:15:00Z"
      },
      {
        "type": "experience",
        "change": "Joined Google as Senior Software Engineer",
        "company": "Google",
        "startDate": "2024-09-20",
        "timestamp": "2024-09-20T09:00:00Z"
      },
      {
        "type": "positionUpdate",
        "position": "Promoted to Lead Software Engineer",
        "company": "Google",
        "timestamp": "2024-09-19T08:00:00Z"
      },
      {
        "type": "countryUpdate",
        "oldCountry": "United States",
        "newCountry": "Canada",
        "timestamp": "2024-09-18T10:00:00Z"
      },
      {
        "type": "skillsUpdate",
        "skill": "Added Machine Learning to skills",
        "timestamp": "2024-09-19T08:00:00Z"
      }
    ]
  },
  "success": true
}

Errors

  • 400 Bad Request: Invalid or missing parameters.
  • 401 Unauthorized: Missing or invalid authorization token.
  • 404 Not Found: Profile or updates not found.