> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kaspr: Get Linkedin Profile

> Get LinkedIn Profile. Kaspr Get Linkedin Profile reference includes SDK V2 and CLI requests, input constraints, response fields, and Deepline cost.

Get LinkedIn Profile.

<Info>
  Tool ID: `kaspr_get_linkedin_profile`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'kaspr_get_linkedin_profile',
  {
    "id": "id_123",
    "name": "Example",
    "dataToGet": [
      "phone"
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute kaspr_get_linkedin_profile --input '{
  "id": "id_123",
  "name": "Example",
  "dataToGet": [
    "phone"
  ]
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "profile": {
      "id": "id_123",
      "name": "Example",
      "firstName": "Jane"
    }
  }
}
```

Use `deepline tools get kaspr_get_linkedin_profile --json` for the latest machine-readable contract.

## Input reference

This endpoint allows you to obtain the work email, direct email, and phone number of a specific prospect or lead using their LinkedIn ID and full name. Do not forget to add "accept-version": "v2.0" to the header.

| Name                   | Type     | Required | Default | Details                                                                                                                                                                                                                        |
| ---------------------- | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `payload.id`           | `string` | Yes      | —       | LinkedIn profile Id or URL                                                                                                                                                                                                     |
| `payload.name`         | `string` | Yes      | —       | profile full name                                                                                                                                                                                                              |
| `payload.dataToGet`    | `array`  | Yes      | —       | Specifies the types of data to include in the response. By default, all allowed fields are selected. Minimum items: 1. Items must be unique.                                                                                   |
| `payload.requiredData` | `array`  | No       | —       | Conditions the response to fetch data only if these fields are present. This field should contain values that also exist in the dataToGet field. By default, no field is required, and the API will return any available data. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "This endpoint allows you to obtain the work email, direct email, and phone number of a specific prospect or lead using their LinkedIn ID and full name. Do not forget to add \"accept-version\": \"v2.0\" to the header.",
    "properties": {
      "id": {
        "type": "string",
        "description": "LinkedIn profile Id or URL"
      },
      "name": {
        "type": "string",
        "description": "profile full name"
      },
      "dataToGet": {
        "type": "array",
        "description": "Specifies the types of data to include in the response. By default, all allowed fields are selected.",
        "minItems": 1,
        "uniqueItems": true,
        "items": {
          "type": "string",
          "enum": [
            "phone",
            "directEmail",
            "workEmail"
          ]
        }
      },
      "requiredData": {
        "type": "array",
        "description": "Conditions the response to fetch data only if these fields are present. This field should contain values that also exist in the dataToGet field. By default, no field is required, and the API will return any available data.",
        "items": {
          "type": "string",
          "enum": [
            "phone",
            "directEmail",
            "workEmail"
          ]
        }
      }
    },
    "required": [
      "id",
      "name",
      "dataToGet"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name                                                               | Type             | Required | Default | Details                    |
| ------------------------------------------------------------------ | ---------------- | -------- | ------- | -------------------------- |
| `result.data`                                                      | `object`         | Yes      | —       | Provider response payload. |
| `result.data.profile`                                              | `object`         | No       | —       | —                          |
| `result.data.profile.id`                                           | `string`         | No       | —       | —                          |
| `result.data.profile.name`                                         | `string`         | No       | —       | —                          |
| `result.data.profile.firstName`                                    | `string`         | No       | —       | —                          |
| `result.data.profile.lastName`                                     | `string`         | No       | —       | —                          |
| `result.data.profile.professionalEmails`                           | `array`          | No       | —       | —                          |
| `result.data.profile.starryProfessionalEmail`                      | `string`         | No       | —       | —                          |
| `result.data.profile.personalEmails`                               | `array`          | No       | —       | —                          |
| `result.data.profile.starryPersonalEmail`                          | `string`         | No       | —       | —                          |
| `result.data.profile.phones`                                       | `array`          | No       | —       | —                          |
| `result.data.profile.starryPhone`                                  | `string`         | No       | —       | —                          |
| `result.data.profile.location`                                     | `string`         | No       | —       | —                          |
| `result.data.profile.title`                                        | `string`         | No       | —       | —                          |
| `result.data.profile.company`                                      | `object \| null` | No       | —       | —                          |
| `result.data.profile.company.addresses`                            | `array`          | No       | —       | —                          |
| `result.data.profile.company.addresses[].country`                  | `string`         | No       | —       | —                          |
| `result.data.profile.company.addresses[].city`                     | `string`         | No       | —       | —                          |
| `result.data.profile.company.addresses[].headquarter`              | `boolean`        | No       | —       | —                          |
| `result.data.profile.company.addresses[].description`              | `string`         | No       | —       | —                          |
| `result.data.profile.company.companyPageUrl`                       | `string`         | No       | —       | —                          |
| `result.data.profile.company.description`                          | `string`         | No       | —       | —                          |
| `result.data.profile.company.domains`                              | `array`          | No       | —       | —                          |
| `result.data.profile.company.fetchedAt`                            | `string`         | No       | —       | —                          |
| `result.data.profile.company.followerCount`                        | `integer`        | No       | —       | —                          |
| `result.data.profile.company.foundedOn`                            | `integer`        | No       | —       | —                          |
| `result.data.profile.company.fundingInfo`                          | `object`         | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.url`                      | `string \| null` | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.source`                   | `string`         | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.roundsNum`                | `number \| null` | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.rounds`                   | `array \| null`  | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.rounds[].type`            | `string`         | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.rounds[].raised`          | `object`         | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.rounds[].raised.currency` | `string`         | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.rounds[].raised.amount`   | `number`         | No       | —       | —                          |
| `result.data.profile.company.fundingInfo.rounds[].announcedOn`     | `string`         | No       | —       | —                          |
| `result.data.profile.company.hashtags`                             | `array`          | No       | —       | —                          |
| `result.data.profile.company.industries`                           | `array`          | No       | —       | —                          |
| `result.data.profile.company.name`                                 | `string`         | No       | —       | —                          |
| `result.data.profile.company.specialities`                         | `array`          | No       | —       | —                          |
| `result.data.profile.company.staffCount`                           | `integer`        | No       | —       | —                          |
| `result.data.profile.company.staffRange`                           | `object`         | No       | —       | —                          |
| `result.data.profile.company.staffRange.start`                     | `integer`        | No       | —       | —                          |
| `result.data.profile.company.staffRange.end`                       | `integer`        | No       | —       | —                          |
| `result.data.profile.company.summary`                              | `string`         | No       | —       | —                          |
| `result.data.profile.company.type`                                 | `string`         | No       | —       | —                          |
| `result.data.profile.company.universalName`                        | `string`         | No       | —       | —                          |
| `result.data.profile.company.staffInterval`                        | `string`         | No       | —       | —                          |
| `result.data.profile.company.industryName`                         | `string`         | No       | —       | —                          |
| `result.data.profile.company.mainAddress`                          | `object`         | No       | —       | —                          |

The table shows the first 50 fields. Expand the raw schema below for every field.

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "profile": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "firstName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              },
              "professionalEmails": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "starryProfessionalEmail": {
                "type": "string"
              },
              "personalEmails": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "starryPersonalEmail": {
                "type": "string"
              },
              "phones": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "starryPhone": {
                "type": "string"
              },
              "location": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "company": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "addresses": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "string"
                        },
                        "city": {
                          "type": "string"
                        },
                        "headquarter": {
                          "type": "boolean"
                        },
                        "description": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "companyPageUrl": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "fetchedAt": {
                    "type": "string"
                  },
                  "followerCount": {
                    "type": "integer"
                  },
                  "foundedOn": {
                    "type": "integer"
                  },
                  "fundingInfo": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "source": {
                        "type": "string"
                      },
                      "roundsNum": {
                        "type": [
                          "number",
                          "null"
                        ]
                      },
                      "rounds": {
                        "type": [
                          "array",
                          "null"
                        ],
                        "items": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string"
                            },
                            "raised": {
                              "type": "object",
                              "properties": {
                                "currency": {
                                  "type": "string"
                                },
                                "amount": {
                                  "type": "number"
                                }
                              },
                              "additionalProperties": false
                            },
                            "announcedOn": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": false
                        }
                      }
                    },
                    "additionalProperties": false
                  },
                  "hashtags": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "industries": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "name": {
                    "type": "string"
                  },
                  "specialities": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    }
                  },
                  "staffCount": {
                    "type": "integer"
                  },
                  "staffRange": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "integer"
                      },
                      "end": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": false
                  },
                  "summary": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  },
                  "universalName": {
                    "type": "string"
                  },
                  "staffInterval": {
                    "type": "string"
                  },
                  "industryName": {
                    "type": "string"
                  },
                  "mainAddress": {
                    "type": "object",
                    "properties": {
                      "country": {
                        "type": "string"
                      },
                      "city": {
                        "type": "string"
                      },
                      "headquarter": {
                        "type": "boolean"
                      },
                      "description": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              "companyName": {
                "type": "string"
              },
              "fetchedAt": {
                "type": "integer"
              },
              "processingTime": {
                "type": "number"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `4.05` per pricing unit.

## Related documentation

* [Kaspr provider guide](/docs/providers/kaspr/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)
