Skip to main content
POST
/
v1
/
network
/
connections
Get Connections
curl --request POST \
  --url https://api.linkupapi.com/v1/network/connections \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "login_token": "<string>",
  "country": "<string>",
  "start_page": 123,
  "end_page": 123,
  "total_results": 123
}
'
{
  "status": "success",
  "data": {
    "total_results": 20,
    "total_available_results": 839,
    "connections": [
      {
        "name": "Linda Källqvist",
        "job_title": "Planhat - VP Customer Success",
        "profile_url": "https://www.linkedin.com/in/lindakallqvist/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/100_100/profile-displayphoto-shrink_100_100/0/1692692323766?e=1753920000&v=beta&t=HQ7CjvtZvsf7oq-tCtgJ82p5Px_oVf0HZlQtQLLjdMA"
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 2,
      "results_per_page": 10,
      "pages_fetched": 2
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Get a list of your LinkedIn connections with their basic information including name, job title, profile URL, and profile picture. Supports both pagination and total results modes.
Credit cost varies based on usage mode:
  • Pagination mode: 1 credit per page
  • Total results mode: 1 credit per 10 connections (rounded up)

​
Header Parameters

​
x-api-key
string
required
Your API key

​
Body Parameters

​
login_token
string
required
LinkedIn authentication cookie obtained from the login/verify process
​
country
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
​
start_page
integer
Starting page number for pagination mode
​
end_page
integer
Ending page number for pagination mode
​
total_results
integer
default:"10"
Number of connections to retrieve (used when not in pagination mode)

​
Response

​
status
string
Request status (success/error)
​
data
object
{
  "status": "success",
  "data": {
    "total_results": 20,
    "total_available_results": 839,
    "connections": [
      {
        "name": "Linda Källqvist",
        "job_title": "Planhat - VP Customer Success",
        "profile_url": "https://www.linkedin.com/in/lindakallqvist/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/100_100/profile-displayphoto-shrink_100_100/0/1692692323766?e=1753920000&v=beta&t=HQ7CjvtZvsf7oq-tCtgJ82p5Px_oVf0HZlQtQLLjdMA"
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 2,
      "results_per_page": 10,
      "pages_fetched": 2
    }
  }
}

​
Error Responses

{
  "status": "error",
  "message": "Insufficient credits available"
}

​
Notes

  • The endpoint supports two modes of operation:
    1. Pagination mode: Specify both start_page and end_page to fetch specific pages
    2. Total results mode: Use total_results to specify the number of connections to fetch
  • The profile picture URL may be ‘N/A’ if not available or if the connection has no profile picture
  • The job title may be ‘N/A’ if the connection hasn’t specified their current position
  • When using pagination, end_page must be greater than or equal to start_page