Get Network Recommendations
curl --request POST \
--url https://api.linkupapi.com/v1/network/recommendations \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"total_results": 123,
"start_page": 123,
"end_page": 123,
"country": "<string>",
"login_token": "<string>"
}
'import requests
url = "https://api.linkupapi.com/v1/network/recommendations"
payload = {
"total_results": 123,
"start_page": 123,
"end_page": 123,
"country": "<string>",
"login_token": "<string>"
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
total_results: 123,
start_page: 123,
end_page: 123,
country: '<string>',
login_token: '<string>'
})
};
fetch('https://api.linkupapi.com/v1/network/recommendations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/network/recommendations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'total_results' => 123,
'start_page' => 123,
'end_page' => 123,
'country' => '<string>',
'login_token' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/network/recommendations"
payload := strings.NewReader("{\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/network/recommendations")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/network/recommendations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"total_results": 3,
"recommendations": [
{
"name": "John Smith",
"subtitle": "Student at Business School 🚀 | Intern at TechCorp 💻",
"profile_url": "https://www.linkedin.com/in/john-smith-bizdev",
"insight": "James and 24 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAAETRgbEBse4dNJFD7gPNwB2DHqdHijuWMUI,PYMK)"
},
{
"name": "Sarah Parker",
"subtitle": "Content Marketing | +6.5k followers on X in 2 months | Content Strategy & Engagement",
"profile_url": "https://www.linkedin.com/in/sarah-parker-539017285",
"insight": "Emma and 19 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAAEU8Uz0BBTKZehAEjjTUUP0iEXeDJ0ThzW4,PYMK)"
},
{
"name": "Michael Johnson",
"subtitle": "Helping entrepreneurs generate qualified leads by automating their marketing process with AI. (effortlessly)",
"profile_url": "https://www.linkedin.com/in/michaeljohnson1",
"insight": "David and 4 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAACjveEcBSGN-I-TMI7NESPgssxZH8AW9LYY,PYMK)"
}
],
"pagination": {
"current_page": 1,
"total_pages": 5,
"pages_fetched": 1
}
}
}
Network Management
Get Network Recommendations
Retrieve LinkedIn network recommendations of people you may know, with optional pagination support
POST
/
v1
/
network
/
recommendations
Get Network Recommendations
curl --request POST \
--url https://api.linkupapi.com/v1/network/recommendations \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"total_results": 123,
"start_page": 123,
"end_page": 123,
"country": "<string>",
"login_token": "<string>"
}
'import requests
url = "https://api.linkupapi.com/v1/network/recommendations"
payload = {
"total_results": 123,
"start_page": 123,
"end_page": 123,
"country": "<string>",
"login_token": "<string>"
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
total_results: 123,
start_page: 123,
end_page: 123,
country: '<string>',
login_token: '<string>'
})
};
fetch('https://api.linkupapi.com/v1/network/recommendations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/network/recommendations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'total_results' => 123,
'start_page' => 123,
'end_page' => 123,
'country' => '<string>',
'login_token' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/network/recommendations"
payload := strings.NewReader("{\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/network/recommendations")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/network/recommendations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"total_results": 3,
"recommendations": [
{
"name": "John Smith",
"subtitle": "Student at Business School 🚀 | Intern at TechCorp 💻",
"profile_url": "https://www.linkedin.com/in/john-smith-bizdev",
"insight": "James and 24 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAAETRgbEBse4dNJFD7gPNwB2DHqdHijuWMUI,PYMK)"
},
{
"name": "Sarah Parker",
"subtitle": "Content Marketing | +6.5k followers on X in 2 months | Content Strategy & Engagement",
"profile_url": "https://www.linkedin.com/in/sarah-parker-539017285",
"insight": "Emma and 19 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAAEU8Uz0BBTKZehAEjjTUUP0iEXeDJ0ThzW4,PYMK)"
},
{
"name": "Michael Johnson",
"subtitle": "Helping entrepreneurs generate qualified leads by automating their marketing process with AI. (effortlessly)",
"profile_url": "https://www.linkedin.com/in/michaeljohnson1",
"insight": "David and 4 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAACjveEcBSGN-I-TMI7NESPgssxZH8AW9LYY,PYMK)"
}
],
"pagination": {
"current_page": 1,
"total_pages": 5,
"pages_fetched": 1
}
}
}
Get personalized LinkedIn connection recommendations including detailed information about each recommended profile. Supports both pagination and total results modes.
Credit Usage:
- In total results mode: 1 credit per 10 results (or fraction thereof)
- 1-10 results = 1 credit
- 11-20 results = 2 credits
- 300 results = 30 credits
- In pagination mode: 1 credit per page requested
- 1 page = 1 credit
- pages 1-3 = 3 credits
Header Parameters
string
required
Your API key
Body Parameters
integer
default:"10"
Maximum number of recommendations to retrieve (used in total results mode)
integer
Starting page number for pagination (optional, enables pagination mode)
integer
Ending page number for pagination (optional, defaults to start_page if not provided)
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
string
required
LinkedIn authentication cookie obtained from the login/verify process
Response
string
Request status (success/error)
object
Show Properties
Show Properties
integer
Number of recommendations returned
array
Show Recommendation Object
Show Recommendation Object
object
Optional pagination information when using pagination mode
{
"status": "success",
"data": {
"total_results": 3,
"recommendations": [
{
"name": "John Smith",
"subtitle": "Student at Business School 🚀 | Intern at TechCorp 💻",
"profile_url": "https://www.linkedin.com/in/john-smith-bizdev",
"insight": "James and 24 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAAETRgbEBse4dNJFD7gPNwB2DHqdHijuWMUI,PYMK)"
},
{
"name": "Sarah Parker",
"subtitle": "Content Marketing | +6.5k followers on X in 2 months | Content Strategy & Engagement",
"profile_url": "https://www.linkedin.com/in/sarah-parker-539017285",
"insight": "Emma and 19 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAAEU8Uz0BBTKZehAEjjTUUP0iEXeDJ0ThzW4,PYMK)"
},
{
"name": "Michael Johnson",
"subtitle": "Helping entrepreneurs generate qualified leads by automating their marketing process with AI. (effortlessly)",
"profile_url": "https://www.linkedin.com/in/michaeljohnson1",
"insight": "David and 4 other mutual connections",
"entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAACjveEcBSGN-I-TMI7NESPgssxZH8AW9LYY,PYMK)"
}
],
"pagination": {
"current_page": 1,
"total_pages": 5,
"pages_fetched": 1
}
}
}
Notes
-
The API supports two modes of operation:
- Total results mode: Specify
total_resultsto get a specific number of recommendations - Pagination mode: Use
start_pageandend_pageto retrieve results page by page (25 results per page)
- Total results mode: Specify
-
The
insightfield indicates either mutual connections or the recommendation reason -
The
entity_urnis a unique identifier used by LinkedIn for the recommendation - Results are sorted by relevance to your profile
- When using pagination mode, the response includes pagination information
- The number of returned recommendations may be less than requested if fewer recommendations are available
Was this page helpful?