> ## 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.
# Context.dev: Contextdev Post People Retrieve
> Get a normalized person profile from identifiers such as an email or social profile URL. Includes inputs, outputs, SDK V2 examples, and Deepline cost.
Get a normalized person profile from identifiers such as an email or social profile URL.
> [!NOTE]
>
> Tool ID: `contextdev_post_people_retrieve`
## 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(
'contextdev_post_people_retrieve',
{
"identifiers": {
"linkedinUrl": "https://example.com/resource"
}
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute contextdev_post_people_retrieve --input '{
"identifiers": {
"linkedinUrl": "https://example.com/resource"
}
}' --json
```
## Example response
The static output schema lacks the details for a reliable example. Use `deepline describe contextdev_post_people_retrieve --json` for the complete live contract.
## Input reference
Retrieve and normalize a person profile from identifiers.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.identifiers` | `object` | Yes | — | Known identifiers for the person. At least one identifier is required. |
| `payload.timeoutMS` | `integer` | No | — | Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes). Minimum: 1000. Maximum: 300000. |
| `payload.tags` | `array` | No | — | Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters. Maximum items: 20. |
Show raw input schema
### Input JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"type": "object",
"description": "Retrieve and normalize a person profile from identifiers.",
"properties": {
"identifiers": {
"type": "object",
"description": "Known identifiers for the person. At least one identifier is required.",
"properties": {
"linkedinUrl": {
"type": "string",
"description": "LinkedIn profile URL, e.g. https://www.linkedin.com/in/yahia-bakour/.",
"format": "uri"
}
},
"additionalProperties": false
},
"timeoutMS": {
"type": "integer",
"description": "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",
"minimum": 1000,
"maximum": 300000
},
"tags": {
"type": "array",
"description": "Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
}
}
},
"required": [
"identifiers"
],
"additionalProperties": false
}
```
## Output reference
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | — |
| `result.data.status` | `"ok"` | Yes | — | Allowed: `ok`. |
| `result.data.code` | `200` | Yes | — | Allowed: `200`. |
| `result.data.person` | `object` | Yes | — | — |
| `result.data.person.profile` | `object` | Yes | — | — |
| `result.data.person.profile.fullName` | `string` | No | — | — |
| `result.data.person.profile.headline` | `string` | No | — | — |
| `result.data.person.profile.location` | `string` | No | — | — |
| `result.data.person.profile.summary` | `string` | No | — | — |
| `result.data.person.profile.profilePictureUrl` | `string` | No | — | Format: `uri`. |
| `result.data.person.education` | `array` | Yes | — | — |
| `result.data.person.education[].institution` | `object` | Yes | — | — |
| `result.data.person.education[].institution.display` | `string` | Yes | — | — |
| `result.data.person.education[].institution.normalized` | `string` | No | — | — |
| `result.data.person.education[].qualification` | `string` | No | — | — |
| `result.data.person.education[].fieldOfStudy` | `string` | No | — | — |
| `result.data.person.education[].description` | `string` | No | — | — |
| `result.data.person.education[].dates` | `object` | No | — | — |
| `result.data.person.education[].dates.startDate` | `object` | No | — | — |
| `result.data.person.education[].dates.startDate.year` | `integer` | Yes | — | — |
| `result.data.person.education[].dates.startDate.month` | `integer` | No | — | Minimum: 1. Maximum: 12. |
| `result.data.person.education[].dates.startDate.day` | `integer` | No | — | Minimum: 1. Maximum: 31. |
| `result.data.person.education[].dates.endDate` | `object` | No | — | — |
| `result.data.person.education[].dates.endDate.year` | `integer` | Yes | — | — |
| `result.data.person.education[].dates.endDate.month` | `integer` | No | — | Minimum: 1. Maximum: 12. |
| `result.data.person.education[].dates.endDate.day` | `integer` | No | — | Minimum: 1. Maximum: 31. |
| `result.data.person.education[].dates.isCurrent` | `boolean` | No | — | — |
| `result.data.person.experience` | `array` | Yes | — | — |
| `result.data.person.experience[].company` | `object` | Yes | — | — |
| `result.data.person.experience[].company.display` | `string` | Yes | — | — |
| `result.data.person.experience[].company.normalized` | `string` | No | — | — |
| `result.data.person.experience[].title` | `string` | Yes | — | — |
| `result.data.person.experience[].description` | `string` | No | — | — |
| `result.data.person.experience[].dates` | `object` | No | — | — |
| `result.data.person.experience[].dates.startDate` | `object` | No | — | — |
| `result.data.person.experience[].dates.startDate.year` | `integer` | Yes | — | — |
| `result.data.person.experience[].dates.startDate.month` | `integer` | No | — | Minimum: 1. Maximum: 12. |
| `result.data.person.experience[].dates.startDate.day` | `integer` | No | — | Minimum: 1. Maximum: 31. |
| `result.data.person.experience[].dates.endDate` | `object` | No | — | — |
| `result.data.person.experience[].dates.endDate.year` | `integer` | Yes | — | — |
| `result.data.person.experience[].dates.endDate.month` | `integer` | No | — | Minimum: 1. Maximum: 12. |
| `result.data.person.experience[].dates.endDate.day` | `integer` | No | — | Minimum: 1. Maximum: 31. |
| `result.data.person.experience[].dates.isCurrent` | `boolean` | No | — | — |
| `result.data.person.skills` | `array` | Yes | — | — |
| `result.data.person.skills[].name` | `string` | Yes | — | — |
| `result.data.person.skills[].normalized` | `string` | No | — | — |
| `result.data.person.skills[].proficiency` | `string` | No | — | — |
| `result.data.metadata` | `object` | Yes | — | — |
| `result.data.metadata.identifiers` | `object` | Yes | — | — |
| `result.data.metadata.identifiers.linkedinUrl` | `string` | No | — | Format: `uri`. |
The table shows the first 50 fields. Expand the raw schema below for every field.
Show raw output schema
### Output JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok"
]
},
"code": {
"type": "integer",
"enum": [
200
]
},
"person": {
"type": "object",
"properties": {
"profile": {
"type": "object",
"properties": {
"fullName": {
"type": "string"
},
"headline": {
"type": "string"
},
"location": {
"type": "string"
},
"summary": {
"type": "string"
},
"profilePictureUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"education": {
"type": "array",
"items": {
"type": "object",
"properties": {
"institution": {
"type": "object",
"properties": {
"display": {
"type": "string"
},
"normalized": {
"type": "string"
}
},
"required": [
"display"
],
"additionalProperties": false
},
"qualification": {
"type": "string"
},
"fieldOfStudy": {
"type": "string"
},
"description": {
"type": "string"
},
"dates": {
"type": "object",
"properties": {
"startDate": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"day": {
"type": "integer",
"minimum": 1,
"maximum": 31
}
},
"required": [
"year"
],
"additionalProperties": false
},
"endDate": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"day": {
"type": "integer",
"minimum": 1,
"maximum": 31
}
},
"required": [
"year"
],
"additionalProperties": false
},
"isCurrent": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"required": [
"institution"
],
"additionalProperties": false
}
},
"experience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "object",
"properties": {
"display": {
"type": "string"
},
"normalized": {
"type": "string"
}
},
"required": [
"display"
],
"additionalProperties": false
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"dates": {
"type": "object",
"properties": {
"startDate": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"day": {
"type": "integer",
"minimum": 1,
"maximum": 31
}
},
"required": [
"year"
],
"additionalProperties": false
},
"endDate": {
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"day": {
"type": "integer",
"minimum": 1,
"maximum": 31
}
},
"required": [
"year"
],
"additionalProperties": false
},
"isCurrent": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"required": [
"company",
"title"
],
"additionalProperties": false
}
},
"skills": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"normalized": {
"type": "string"
},
"proficiency": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
}
}
},
"required": [
"profile",
"education",
"experience",
"skills"
],
"additionalProperties": false
},
"metadata": {
"type": "object",
"properties": {
"identifiers": {
"type": "object",
"properties": {
"linkedinUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"personalWebsiteUrl": {
"type": "string",
"format": "uri"
},
"urlsAnalyzed": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"sourcesAttempted": {
"type": "array",
"items": {
"type": "string",
"enum": [
"linkedin",
"cv",
"manual",
"github",
"other"
]
}
},
"sourcesSucceeded": {
"type": "array",
"items": {
"type": "string",
"enum": [
"linkedin",
"cv",
"manual",
"github",
"other"
]
}
}
},
"required": [
"identifiers",
"urlsAnalyzed",
"sourcesAttempted",
"sourcesSucceeded"
],
"additionalProperties": false
},
"key_metadata": {
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}
},
"required": [
"status",
"code",
"person",
"metadata"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Deepline cost
* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.01` per pricing unit.
## Related documentation
* [Context.dev provider guide](https://deepline.com/docs/providers/contextdev/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.