Skip to main content

Networking

Retrieving connections

This endpoint allows you to retrieve a list of your LinkedIn connections, applying various filters.

POST https://api.linkedapi.io/account/connections.get

Body


{
  "filter": {
    "firstName": "John",
    "lastName": "Doe",
    "position": "CEO",
    "locations": ["New York", "San Francisco", "London"],
    "industries": ["Software Development", "Professional Services"],
    "currentCompanies": ["Tech Solutions", "Innovatech"],
    "previousCompanies": ["FutureCorp"]
  }
}
  • filter (optional) – filter configuration object.
    • firstName (optional) – first name of person.
    • lastName (optional) – last name of person.
    • position (optional) – job position of person.
    • locations (optional) – array of free-form strings representing locations. Matches if person is located in any of the listed locations.
    • industries (optional) – array of enums representing industries. Matches if person works in any of the listed industries. Takes specific values available in the LinkedIn interface.
    • currentCompanies (optional) – array of company names. Matches if person currently works at any of the listed companies.
    • previousCompanies (optional) – array of company names. Matches if person previously worked at any of the listed companies.
    • schools (optional) – array of institution names. Matches if person currently attends or previously attended any of the listed institutions.
When multiple filter fields are specified, they are combined using AND logic. If the filter configuration object is omitted, the full list of connections will be returned.

Response


{
  "status": "complete",
  "completion": [
    {
      "name": "John Doe",
      "publicUrl": "https://www.linkedin.com/in/johndoe",
      "headline": "Founder & CEO at Example Company",
      "location": "Lisbon, Portugal"
    },
    {
      "name": "Jane Smith",
      "publicUrl": "https://www.linkedin.com/in/janesmith",
      "headline": "CEO at Tech Solutions",
      "location": "San Francisco Bay Area"
    },
    {
      "name": "Carlos Santos",
      "publicUrl": "https://www.linkedin.com/in/carlossantos",
      "headline": "Project Manager at Startup Hub",
      "location": "Madrid"
    }
  ]
}
  • name – full name of the person.
  • publicUrl – public LinkedIn URL of the person.
  • headline – headline of the person.
  • location – free-form string indicating the person's location.
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.