POST
/
v1
/
network
/
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
    }
  }
}

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)

​
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