> ## 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 Network Recommendations

> Retrieve network recommendations (people you may know).

## Overview

Returns a one-shot snapshot of recommended connections ("People You May Know") sourced from the platform's discovery sections.

<Note>One-shot snapshot — not paginable. Use `count` to limit results. Consumes **1 credit per 10 results**.</Note>

## Request

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication.
</ParamField>

<ParamField body="account_id" type="string" required>
  The unique identifier of the account to use.
</ParamField>

<ParamField body="action" type="string" required>
  Must be `"recommendations"`.
</ParamField>

<ParamField body="params" type="object">
  <Expandable title="params properties">
    <ParamField body="count" type="integer" default={10}>
      Number of recommendations to return. Defaults to `10`. The total available depends on the account's network — typically 10 to 50 unique profiles per snapshot.
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates whether the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data properties">
    <ResponseField name="recommendations" type="array">
      List of recommended profiles.

      <Expandable title="recommendation properties">
        <ResponseField name="name" type="string">Display name.</ResponseField>
        <ResponseField name="subtitle" type="string">Headline / current role.</ResponseField>
        <ResponseField name="profile_url" type="string">Public profile URL.</ResponseField>
        <ResponseField name="profile_picture" type="string">Profile picture URL.</ResponseField>
        <ResponseField name="insight" type="string">Mutual connection / shared context (e.g. `"John and 35 other mutual connections"`).</ResponseField>
        <ResponseField name="entity_urn" type="string">Unique identifier of the discovery view. Treat it as an opaque string and pass it back exactly as returned.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total_results" type="integer">Number of recommendations returned in this response.</ResponseField>

    <ResponseField name="pagination" type="object">
      <Expandable title="pagination properties">
        <ResponseField name="results_per_page" type="integer">Page size used internally per upstream request (10).</ResponseField>
        <ResponseField name="pages_fetched" type="integer">Number of internal upstream batches consumed to assemble the response.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  <Expandable title="metadata properties">
    <ResponseField name="action" type="string">The action that was performed (`"recommendations"`).</ResponseField>
    <ResponseField name="account_id" type="string">The account ID used for the request.</ResponseField>
    <ResponseField name="credits_consumed" type="integer">Number of credits consumed (1 per 10 results).</ResponseField>
    <ResponseField name="timestamp" type="string">ISO 8601 timestamp of the response.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "recommendations": [
        {
          "name": "Jane Doe",
          "subtitle": "Co-founder @ Acme Corp",
          "profile_url": "https://www.linkedin.com/in/jane-doe-42",
          "insight": "John and 35 other mutual connections",
          "entity_urn": "urn:li:fsd_discoveryEntityViewModel:(urn:li:fsd_profile:ACoAA...,PYMK)",
          "profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg"
        }
      ],
      "total_results": 1,
      "pagination": {
        "results_per_page": 10,
        "pages_fetched": 1
      }
    },
    "metadata": {
      "action": "recommendations",
      "account_id": "your-account-id",
      "credits_consumed": 1,
      "timestamp": "2026-04-26T10:35:00Z"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_PARAMS",
      "message": "account_id is required."
    },
    "metadata": {
      "action": "recommendations",
      "account_id": null,
      "credits_consumed": 0,
      "timestamp": "2026-04-26T10:35:00Z"
    }
  }
  ```
</ResponseExample>