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

> Find a person's work email, direct email and phone number from their LinkedIn ID and full name. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Find a person's work email, direct email and phone number from their LinkedIn ID and full name.

> [!NOTE]
>
> Tool ID: `kaspr_get_linkedin_profile`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute kaspr_get_linkedin_profile --input '{
  "id": "id_123",
  "name": "Example",
  "dataToGet": [
    "phone"
  ]
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "profile": {
      "id": "id_123",
      "name": "Example",
      "firstName": "Jane"
    }
  }
}
```

Use `deepline describe 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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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](https://deepline.com/docs/providers/kaspr/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.