Skip to main content

Engagements

Visiting people

This endpoint allows you to visit the LinkedIn profiles of specified people.

POST https://api.linkedapi.io/account/people.visit

Body


{
  "people": [
    "https://www.linkedin.com/in/person1",
    "https://www.linkedin.com/in/person2",
    "https://www.linkedin.com/in/person3"
  ]
}
  • people – LinkedIn URLs of people you want to visit.

Response

  1. If all visits are successful:

{
  "status": "complete",
  "completion": [
    {
      "person": "https://www.linkedin.com/in/person1",
      "result": {
        "success": true
      }
    },
    {
      "person": "https://www.linkedin.com/in/person2",
      "result": {
        "success": true
      }
    },
    {
      "person": "https://www.linkedin.com/in/person3",
      "result": {
        "success": true
      }
    }
  ]
}
  1. If some visits are unsuccessful:

{
  "status": "complete",
  "completion": [
    {
      "person": "https://www.linkedin.com/in/person1",
      "result": {
        "success": true
      }
    },
    {
      "person": "https://www.linkedin.com/in/person2",
      "result": {
        "success": false,
        "error": {
          "errorType": "personNotFound",
          "message": "The provided URL is not an existing LinkedIn person."
        }
      }
    },
    {
      "person": "https://www.linkedin.com/in/person3",
      "result": {
        "success": true
      }
    }
  ]
}
  • errorType – enum with the following possible values:
    • personNotFound – provided URL is not an existing LinkedIn person.
Throughout the documentation, for simplicity, only the request body and final response (when status is complete) are shown. Consider possible global errors and result handling options for proper implementation.