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,
  "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
    }
  }
}

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)

​
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