POST
/
v1
/
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,
  "country": "<string>",
  "login_token": "<string>"
}'
{
  "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)"
      }
    ]
  }
}

Get personalized LinkedIn connection recommendations including detailed information about each recommended profile.

Credit Usage: 1 credit per 10 results (or fraction thereof). For example:

  • 1-10 results = 1 credit
  • 11-20 results = 2 credits
  • 300 results = 30 credits

​
Header Parameters

​
x-api-key
string
required

Your API key

​
Body Parameters

​
total_results
integer
default:"10"

Maximum number of recommendations to retrieve

​
country
string
default:"FR"

Country code for proxy selection. Available: (US,UK,FR)

​
login_token
string
required

LinkedIn authentication cookie obtained from the login/verify process

​
Response

​
status
string

Request status (success/error)

​
data
object
{
  "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)"
      }
    ]
  }
}

​
Notes

  • The API returns personalized recommendations based on your LinkedIn profile and network

  • The insight field indicates either mutual connections or the recommendation reason

  • The entity_urn is a unique identifier used by LinkedIn for the recommendation

  • Results are sorted by relevance to your prfile

  • The number of returned recommendations may be less than total_results if fewer recommendations are available