Skip to main content
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>"
}
'
{
  "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
    }
  }
}

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 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

​
x-api-key
string
required
Your API key

​
Body Parameters

​
total_results
integer
default:"10"
Maximum number of recommendations to retrieve (used in total results mode)
​
start_page
integer
Starting page number for pagination (optional, enables pagination mode)
​
end_page
integer
Ending page number for pagination (optional, defaults to start_page if not provided)
​
country
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
​
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)"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 5,
      "pages_fetched": 1
    }
  }
}

​
Notes

  • The API supports two modes of operation:
    • Total results mode: Specify total_results to get a specific number of recommendations
    • Pagination mode: Use start_page and end_page to retrieve results page by page (25 results per page)
  • 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 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