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

# Unipile: Linkedin List Job Applicants

> List the applicants to one LinkedIn job posting. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the applicants to one LinkedIn job posting.

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

## 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(
  'unipile_linkedin_list_job_applicants',
  {
    "account_id": "123456789",
    "id": "id_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute unipile_linkedin_list_job_applicants --input '{
  "account_id": "123456789",
  "id": "id_123"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe unipile_linkedin_list_job_applicants --json` for the complete live contract.

## Input reference

Retrieve all the users that have applied to a given offer.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.max_years_in_company` | `number` | No | — | Linkedin Recruiter native filter : YEARS IN CURRENT COMPANY. |
| `payload.min_years_in_company` | `number` | No | — | Linkedin Recruiter native filter : YEARS IN CURRENT COMPANY. |
| `payload.max_years_in_position` | `number` | No | — | Linkedin Recruiter native filter : YEARS IN CURRENT POSITION. |
| `payload.min_years_in_position` | `number` | No | — | Linkedin Recruiter native filter : YEARS IN CURRENT POSITION. |
| `payload.max_years_of_experience` | `number` | No | — | Linkedin Recruiter native filter : YEARS OF EXPERIENCE. |
| `payload.min_years_of_experience` | `number` | No | — | Linkedin Recruiter native filter : YEARS OF EXPERIENCE. |
| `payload.exclude_degree` | `array` | No | — | Linkedin Recruiter native filter : DEGREES (excluded). |
| `payload.include_degree` | `array` | No | — | Linkedin Recruiter native filter : DEGREES (included). |
| `payload.include_archived` | `boolean` | No | — | Whether the results should include archived applicants. Recruiter only. |
| `payload.ratings` | `string` | No | — | One or more ratings (UNRATED, GOOD\_FIT, MAYBE, NOT\_A\_FIT) separated by commas. Classic only. |
| `payload.keywords` | `string` | No | — | Filter results with keywords. |
| `payload.sort_by` | `"relevance" \| "alphabetical" \| "newest_first" \| "screening_requirements"` | No | — | The sorting rule for applicants. Recruiter only. Allowed: `relevance`, `alphabetical`, `newest_first`, `screening_requirements`. |
| `payload.service` | `"CLASSIC" \| "RECRUITER"` | No | — | The Linkedin service the job posting depends on. Default is classic. Allowed: `CLASSIC`, `RECRUITER`. |
| `payload.limit` | `integer` | No | `10` | A limit for the number of items returned in the response. The value can be set between 1 and 100. Minimum: 1. Maximum: 100. |
| `payload.cursor` | `string` | No | — | A cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved. Minimum length: 1. |
| `payload.account_id` | `string` | Yes | — | The ID of the account to trigger the request from. |
| `payload.id` | `string` | Yes | — | The ID of the job offer. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve all the users that have applied to a given offer.",
    "properties": {
      "max_years_in_company": {
        "type": "number",
        "description": "Linkedin Recruiter native filter : YEARS IN CURRENT COMPANY."
      },
      "min_years_in_company": {
        "type": "number",
        "description": "Linkedin Recruiter native filter : YEARS IN CURRENT COMPANY."
      },
      "max_years_in_position": {
        "type": "number",
        "description": "Linkedin Recruiter native filter : YEARS IN CURRENT POSITION."
      },
      "min_years_in_position": {
        "type": "number",
        "description": "Linkedin Recruiter native filter : YEARS IN CURRENT POSITION."
      },
      "max_years_of_experience": {
        "type": "number",
        "description": "Linkedin Recruiter native filter : YEARS OF EXPERIENCE."
      },
      "min_years_of_experience": {
        "type": "number",
        "description": "Linkedin Recruiter native filter : YEARS OF EXPERIENCE."
      },
      "exclude_degree": {
        "type": "array",
        "description": "Linkedin Recruiter native filter : DEGREES (excluded).",
        "items": {
          "type": "string"
        }
      },
      "include_degree": {
        "type": "array",
        "description": "Linkedin Recruiter native filter : DEGREES (included).",
        "items": {
          "type": "string"
        }
      },
      "include_archived": {
        "type": "boolean",
        "description": "Whether the results should include archived applicants. Recruiter only."
      },
      "ratings": {
        "type": "string",
        "description": "One or more ratings (UNRATED, GOOD_FIT, MAYBE, NOT_A_FIT) separated by commas. Classic only."
      },
      "keywords": {
        "type": "string",
        "description": "Filter results with keywords."
      },
      "sort_by": {
        "type": "string",
        "description": "The sorting rule for applicants. Recruiter only.",
        "enum": [
          "relevance",
          "alphabetical",
          "newest_first",
          "screening_requirements"
        ]
      },
      "service": {
        "type": "string",
        "description": "The Linkedin service the job posting depends on. Default is classic.",
        "enum": [
          "CLASSIC",
          "RECRUITER"
        ]
      },
      "limit": {
        "type": "integer",
        "description": "A limit for the number of items returned in the response. The value can be set between 1 and 100.",
        "default": 10,
        "minimum": 1,
        "maximum": 100
      },
      "cursor": {
        "type": "string",
        "description": "A cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.",
        "minLength": 1
      },
      "account_id": {
        "type": "string",
        "description": "The ID of the account to trigger the request from."
      },
      "id": {
        "type": "string",
        "description": "The ID of the job offer."
      }
    },
    "required": [
      "account_id",
      "id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.object` | `"LinkedinJobApplicantList"` | Yes | — | Allowed: `LinkedinJobApplicantList`. |
| `result.data.job_posting_id` | `string` | Yes | — | A unique identifier. Minimum length: 1. |
| `result.data.items` | `array` | Yes | — | — |
| `result.data.items[].object` | `"LinkedinJobApplicant"` | Yes | — | Allowed: `LinkedinJobApplicant`. |
| `result.data.items[].id` | `string` | Yes | — | — |
| `result.data.items[].profile_id` | `string` | Yes | — | — |
| `result.data.items[].public_identifier` | `string` | Yes | — | — |
| `result.data.items[].public_profile_url` | `string` | Yes | — | — |
| `result.data.items[].name` | `string` | Yes | — | — |
| `result.data.items[].location` | `string` | Yes | — | — |
| `result.data.items[].headline` | `string` | Yes | — | — |
| `result.data.items[].profile_picture_url` | `string` | No | — | — |
| `result.data.items[].applied_at` | `number` | Yes | — | — |
| `result.data.items[].rating` | `"UNRATED" \| "GOOD_FIT" \| "MAYBE" \| "NOT_A_FIT"` | Yes | — | Allowed: `UNRATED`, `GOOD_FIT`, `MAYBE`, `NOT_A_FIT`. |
| `result.data.items[].hiring_state` | `string` | No | — | — |
| `result.data.items[].email_address` | `string` | No | — | — |
| `result.data.items[].phone_number` | `string` | No | — | — |
| `result.data.items[].contact_info` | `object` | No | — | — |
| `result.data.items[].contact_info.email_addresses` | `array` | Yes | — | — |
| `result.data.items[].contact_info.phone_numbers` | `array` | Yes | — | — |
| `result.data.items[].work_experience` | `array` | Yes | — | — |
| `result.data.items[].work_experience[].company` | `string \| null` | Yes | — | — |
| `result.data.items[].work_experience[].company_id` | `string` | No | — | — |
| `result.data.items[].work_experience[].position` | `string \| null` | Yes | — | — |
| `result.data.items[].work_experience[].location` | `string` | No | — | — |
| `result.data.items[].work_experience[].description` | `string` | No | — | — |
| `result.data.items[].work_experience[].picture_url` | `string` | No | — | — |
| `result.data.items[].work_experience[].start` | `object \| null` | Yes | — | — |
| `result.data.items[].work_experience[].start.year` | `number` | Yes | — | — |
| `result.data.items[].work_experience[].start.month` | `number` | Yes | — | — |
| `result.data.items[].work_experience[].end` | `object \| null` | Yes | — | — |
| `result.data.items[].work_experience[].end.year` | `number` | Yes | — | — |
| `result.data.items[].work_experience[].end.month` | `number` | Yes | — | — |
| `result.data.items[].education` | `array` | Yes | — | — |
| `result.data.items[].education[].school` | `string \| null` | Yes | — | — |
| `result.data.items[].education[].school_id` | `string` | No | — | — |
| `result.data.items[].education[].degree` | `string` | No | — | — |
| `result.data.items[].education[].description` | `string` | No | — | — |
| `result.data.items[].education[].field_of_study` | `string` | No | — | — |
| `result.data.items[].education[].picture_url` | `string` | No | — | — |
| `result.data.items[].education[].start` | `object \| null` | Yes | — | — |
| `result.data.items[].education[].start.year` | `number` | Yes | — | — |
| `result.data.items[].education[].start.month` | `number` | Yes | — | — |
| `result.data.items[].education[].end` | `object \| null` | Yes | — | — |
| `result.data.items[].education[].end.year` | `number` | Yes | — | — |
| `result.data.items[].education[].end.month` | `number` | Yes | — | — |
| `result.data.items[].screening_questions` | `array` | Yes | — | — |
| `result.data.items[].screening_questions[].question` | `string` | Yes | — | — |
| `result.data.items[].screening_questions[].answers` | `array` | Yes | — | — |

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": {
          "object": {
            "type": "string",
            "enum": [
              "LinkedinJobApplicantList"
            ]
          },
          "job_posting_id": {
            "type": "string",
            "description": "A unique identifier.",
            "minLength": 1
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "object": {
                  "type": "string",
                  "enum": [
                    "LinkedinJobApplicant"
                  ]
                },
                "id": {
                  "type": "string"
                },
                "profile_id": {
                  "type": "string"
                },
                "public_identifier": {
                  "type": "string"
                },
                "public_profile_url": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "location": {
                  "type": "string"
                },
                "headline": {
                  "type": "string"
                },
                "profile_picture_url": {
                  "type": "string"
                },
                "applied_at": {
                  "type": "number"
                },
                "rating": {
                  "type": "string",
                  "enum": [
                    "UNRATED",
                    "GOOD_FIT",
                    "MAYBE",
                    "NOT_A_FIT"
                  ]
                },
                "hiring_state": {
                  "type": "string"
                },
                "email_address": {
                  "type": "string"
                },
                "phone_number": {
                  "type": "string"
                },
                "contact_info": {
                  "type": "object",
                  "properties": {
                    "email_addresses": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "phone_numbers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "email_addresses",
                    "phone_numbers"
                  ],
                  "additionalProperties": false
                },
                "work_experience": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "company": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "company_id": {
                        "type": "string"
                      },
                      "position": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "location": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "picture_url": {
                        "type": "string"
                      },
                      "start": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "properties": {
                          "year": {
                            "type": "number"
                          },
                          "month": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "year",
                          "month"
                        ],
                        "additionalProperties": false
                      },
                      "end": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "properties": {
                          "year": {
                            "type": "number"
                          },
                          "month": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "year",
                          "month"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "company",
                      "position",
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  }
                },
                "education": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "school": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "school_id": {
                        "type": "string"
                      },
                      "degree": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "field_of_study": {
                        "type": "string"
                      },
                      "picture_url": {
                        "type": "string"
                      },
                      "start": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "properties": {
                          "year": {
                            "type": "number"
                          },
                          "month": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "year",
                          "month"
                        ],
                        "additionalProperties": false
                      },
                      "end": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "properties": {
                          "year": {
                            "type": "number"
                          },
                          "month": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "year",
                          "month"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "school",
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  }
                },
                "screening_questions": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "question": {
                        "type": "string"
                      },
                      "answers": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "success": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "question",
                      "answers",
                      "success"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "object",
                "id",
                "profile_id",
                "public_identifier",
                "public_profile_url",
                "name",
                "location",
                "headline",
                "applied_at",
                "rating",
                "work_experience",
                "education",
                "screening_questions"
              ],
              "additionalProperties": false
            }
          },
          "cursor": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          },
          "paging": {
            "type": "object",
            "properties": {
              "page_count": {
                "type": "number"
              },
              "total_count": {
                "type": "number"
              }
            },
            "required": [
              "page_count",
              "total_count"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "object",
          "job_posting_id",
          "items",
          "cursor",
          "paging"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Unipile provider guide](https://deepline.com/docs/providers/unipile/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.