> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/search/openapi.json](/docs/api/search/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# People and company search: Search people at given companies

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

One endpoint of [People and company search](/docs/api/search.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Search people at given companies

`POST /v1/search/companies/people` - operationId `search.search-company-people`

| Permission | Rate limit |
| --- | --- |
| Search view | 200 requests a minute per API key |

Search people at the companies you name, for example after a company search.

Send a `POST /v1/search/people` body plus `companyIds`, the `kenId` values of the companies. The
answer is a people search page.

Errors:

- `400 validation_failed`: a filter is not valid.
- `402 plan_required`: the body holds a funding filter (as on `POST /v1/search/people`) and the
workspace's plan does not include funding signals (`error.refusal` feature `funding_signals`).
- `403 feature_disabled`: a lookalike filter needs the `lookalikes` feature.
- `422 no_usable_seeds`: Kenso could not use any lookalike seed.
- `429 quota_exceeded`: the daily quota is used up.

Requires Search view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/search/POST/v1/search/companies/people)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a `SearchPeopleResults`.

| Field | Type | Description |
| --- | --- | --- |
| `totalResults` | integer (int64) | How many people match the search in all. A `behaviorTags` filter does not change it. |
| `page` | integer (int32) | The page number, from 1. |
| `pageSize` | integer (int32) | The most people a page holds. |
| `searchAfter` | string | The cursor of the next page: send it back unchanged as `searchAfter`. Null when there is none. |
| `hasMore` | boolean | True when more people match after this page. |
| `results` | array of SearchPerson | The people on this page. |
| `facets` | SearchPeopleFacets | Always null here: `POST /v1/search/people/facets` counts the filter values. |
| `dataAsOf` | string | The date of the newest profile check in the index, as `yyyy-MM-dd`. `newInSeat` and `newInRole` count back from it. |
| `lookalikeSeeds` | SearchPeopleLookalikeSeeds | How each lookalike seed resolved. Present only on a lookalike search. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/search/companies/people" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": {
    "totalResults": 1,
    "page": 1,
    "pageSize": 1,
    "searchAfter": "string",
    "hasMore": true,
    "results": [
      {
        "kenId": 812,
        "fullName": "Jane Doe",
        "firstName": "Jane",
        "lastName": "Doe",
        "headline": "string",
        "summary": "string",
        "location": "string",
        "city": "string",
        "state": "string",
        "country": "string",
        "countryIso2": "US",
        "countryIso3": "USA",
        "industry": "string",
        "linkedInUrl": "https://example.com",
        "profilePhotoUrl": "https://example.com",
        "publicProfileId": "string",
        "shorthandName": "string",
        "canonicalShorthandName": "string",
        "services": "string",
        "connectionsCount": 1,
        "followerCount": 1,
        "recommendationsCount": 1,
        "experienceCount": 1,
        "currentTitle": "string",
        "currentCompanyName": "string",
        "currentCompanyId": 812,
        "headquartersCountry": "string",
        "headquartersCity": "string",
        "headquartersState": "string",
        "headquartersCountryIso2": "string",
        "employeesCount": 1,
        "companyType": "string",
        "companySize": "51-200",
        "companyDomain": "example.com",
        "companyLinkedInUrl": "https://example.com",
        "companyDescription": "string",
        "companyLogoUrl": "https://example.com",
        "companyFounded": 1,
        "companyFollowers": 1,
        "companyTotalFunding": 1,
        "companyLastFundingRoundType": "string",
        "companyLastFundingAmount": 1,
        "companyFundingTotalUsd": 1,
        "companyLastFundedAt": "string",
        "companySpecialties": [
          "string"
        ],
        "companyWebTechnologies": [
          {
            "key": "string",
            "name": "string"
          }
        ],
        "seniorityLevel": "Director",
        "seniorityConfidence": 0.5,
        "function": "Sales",
        "isDecisionMaker": true,
        "yearsOfExperience": 0.5,
        "yearsInCurrentRole": 0.5,
        "yearsInCurrentCompany": 0.5,
        "skills": [
          "string"
        ],
        "languages": [
          "string"
        ],
        "regions": [
          "string"
        ],
        "certifications": [
          {
            "title": "string",
            "issuer": "string",
            "credentialId": "string",
            "certificateUrl": "https://example.com",
            "certificateLogoUrl": "https://example.com",
            "issuerUrl": "https://example.com",
            "startDate": "2021-03-01T00:00:00",
            "endDate": "2021-03-01T00:00:00"
          }
        ],
        "changedJobRecently": true,
        "newInSeat": true,
        "newInRole": true,
        "tenureRipe": true,
        "jobChangeDate": "2021-03-01T00:00:00",
        "titleChangedRecently": true,
        "promoted": true,
        "seniorityIncreased": true,
        "previousTitle": "string",
        "previousSeniorityLevel": "string",
        "titleChangeDetectedMonth": "2021-03-01T00:00:00",
        "previousCompanyName": "string",
        "jobChangeDetectedMonth": "2021-03-01T00:00:00",
        "createdAt": "2021-03-01T00:00:00",
        "checkedAt": "2021-03-01T00:00:00",
        "experience": [
          {
            "companyId": 812,
            "companyName": "Acme",
            "companyUrl": "https://example.com",
            "companyLogoUrl": "https://example.com",
            "title": "string",
            "location": "string",
            "isCurrent": true,
            "startDate": "2021-03-01T00:00:00",
            "endDate": "2021-03-01T00:00:00",
            "durationMonths": 1,
            "seniorityLevel": "string",
            "description": "string"
          }
        ],
        "education": [
          {
            "schoolName": "string",
            "degree": "string",
            "fieldOfStudy": "string",
            "schoolUrl": "https://example.com",
            "schoolLogoUrl": "https://example.com",
            "description": "string",
            "activitiesAndSocieties": "string",
            "startDate": "2021-03-01T00:00:00",
            "endDate": "2021-03-01T00:00:00"
          }
        ],
        "awards": [
          {
            "title": "string",
            "issuer": "string",
            "description": "string",
            "date": "string"
          }
        ],
        "organizations": [
          {
            "name": "string",
            "position": "string",
            "description": "string",
            "startDate": "2021-03-01T00:00:00",
            "endDate": "2021-03-01T00:00:00"
          }
        ],
        "recommendations": [
          {
            "text": "string",
            "recommenderName": "string",
            "recommenderUrl": "https://example.com"
          }
        ],
        "publications": [
          {
            "title": "string",
            "publisher": "string",
            "description": "string",
            "url": "https://example.com",
            "authors": [],
            "date": "2021-03-01T00:00:00"
          }
        ],
        "patents": [
          {
            "title": "string",
            "description": "string",
            "patentNumber": "string",
            "url": "https://example.com",
            "status": "string",
            "inventors": [],
            "date": "2021-03-01T00:00:00"
          }
        ],
        "volunteering": [
          {
            "organization": "string",
            "role": "string",
            "cause": "string",
            "description": "string",
            "startDate": "2021-03-01T00:00:00",
            "endDate": "2021-03-01T00:00:00"
          }
        ],
        "websites": [
          {
            "url": "https://example.com"
          }
        ],
        "activity": [
          {
            "activityUrl": "https://example.com",
            "title": "string",
            "action": "string"
          }
        ],
        "courseSuggestions": [
          {
            "title": "string",
            "courseUrl": "https://example.com"
          }
        ],
        "similarProfiles": [
          {
            "profileUrl": "https://example.com",
            "fullName": "Jane Doe",
            "headline": "string",
            "location": "string",
            "company": "string",
            "followers": 1
          }
        ],
        "alsoViewed": [
          {
            "profileUrl": "https://example.com",
            "fullName": "Jane Doe",
            "headline": "string",
            "location": "string",
            "company": "string",
            "followers": 1
          }
        ],
        "othersNamed": [
          {
            "profileUrl": "https://example.com",
            "fullName": "Jane Doe",
            "headline": "string",
            "location": "string",
            "company": "string",
            "followers": 1
          }
        ],
        "courses": [
          {
            "title": "string",
            "number": "string"
          }
        ],
        "groups": [
          {
            "name": "string",
            "url": "https://example.com"
          }
        ],
        "interests": [
          {
            "name": "string"
          }
        ],
        "projects": [
          {
            "title": "string",
            "description": "string",
            "url": "https://example.com",
            "startDate": "2021-03-01T00:00:00",
            "endDate": "2021-03-01T00:00:00",
            "teamMembers": []
          }
        ],
        "testScores": [
          {
            "title": "string",
            "score": "string",
            "description": "string",
            "date": "2021-03-01T00:00:00"
          }
        ],
        "hiddenDetails": [
          "string"
        ],
        "volunteeringCares": [
          "string"
        ],
        "volunteeringOpportunities": [
          "string"
        ],
        "volunteeringSupports": [
          "string"
        ],
        "postsSeeMoreUrls": [
          "https://example.com"
        ],
        "relevanceScore": 0.5,
        "lookalike": {
          "score": 1,
          "grade": 1
        },
        "matchedCurrentRole": {
          "title": "string",
          "companyName": "Acme",
          "companyId": 812
        },
        "hasKenEmail": true,
        "kenEmailStatus": "none",
        "searchToken": "string",
        "behaviorTags": [
          "string"
        ]
      }
    ],
    "facets": {
      "industries": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "seniorityLevels": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "functions": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "countries": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "states": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "cities": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "companyTypes": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "companySizes": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "fundingRoundTypes": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "webTech": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ],
      "webTechCategories": [
        {
          "value": "string",
          "count": 1,
          "label": "string"
        }
      ]
    },
    "dataAsOf": "string",
    "lookalikeSeeds": {
      "resolved": [
        {
          "input": "string",
          "companyId": 812,
          "personId": 812,
          "name": "string",
          "domain": "example.com"
        }
      ],
      "unresolved": [
        {
          "input": "string",
          "reason": "not_found"
        }
      ]
    }
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### SearchPerson

A person in Kenso's people index. With `view=summary`, a people search returns only the fields a list row shows, and the others are absent.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kenId` | integer (int64) | no | The person's Search id. Send it as `personId` to get the person again. |
| `fullName` | string | no | The person's full name. |
| `firstName` | string | no | The person's first name. |
| `lastName` | string | no | The person's last name. |
| `headline` | string | no | The headline of the person's LinkedIn profile. |
| `summary` | string | no | The about text of the person's profile. |
| `location` | string | no | Where the person is, as their profile writes it. |
| `city` | string | no | The person's city. |
| `state` | string | no | The person's state or region. |
| `country` | string | no | The person's country. |
| `countryIso2` | string | no | The person's country as an ISO 3166-1 alpha-2 code, such as `US`. |
| `countryIso3` | string | no | The person's country as an ISO 3166-1 alpha-3 code, such as `USA`. |
| `industry` | string | no | The industry the person works in. |
| `linkedInUrl` | string | no | The person's LinkedIn profile URL. |
| `profilePhotoUrl` | string | no | The URL of the person's profile photo. |
| `publicProfileId` | string | no | The id of the person's public LinkedIn profile. |
| `shorthandName` | string | no | The person's LinkedIn handle, the part of the profile URL after `/in/`. |
| `canonicalShorthandName` | string | no | The canonical form of `shorthandName`. |
| `services` | string | no | The services the person offers on their profile, as one text. |
| `connectionsCount` | integer (int32) | no | How many LinkedIn connections the person has. |
| `followerCount` | integer (int32) | no | How many LinkedIn followers the person has. |
| `recommendationsCount` | integer (int32) | no | How many recommendations the person's profile holds. |
| `experienceCount` | integer (int32) | no | How many positions the person's work history lists. |
| `currentTitle` | string | no | The person's current job title. |
| `currentCompanyName` | string | no | The name of the person's current company. |
| `currentCompanyId` | integer (int64) | no | The Search id of the person's current company: the `kenId` of a company search result. |
| `headquartersCountry` | string | no | The country of the current company's headquarters. |
| `headquartersCity` | string | no | The city of the current company's headquarters. |
| `headquartersState` | string | no | The state or region of the current company's headquarters. |
| `headquartersCountryIso2` | string | no | The country of the current company's headquarters as an ISO 3166-1 alpha-2 code. |
| `employeesCount` | integer (int32) | no | How many employees the current company has. |
| `companyType` | string | no | The current company's type, such as `Privately Held`. |
| `companySize` | string | no | The current company's employee range, such as `51-200`. |
| `companyDomain` | string | no | The current company's website domain. |
| `companyLinkedInUrl` | string | no | The current company's LinkedIn page URL. |
| `companyDescription` | string | no | The current company's description. |
| `companyLogoUrl` | string | no | The URL of the current company's logo. |
| `companyFounded` | integer (int32) | no | The year the current company was founded. |
| `companyFollowers` | integer (int32) | no | How many LinkedIn followers the current company has. |
| `companyTotalFunding` | integer (int64) | no | The current company's total funding as listed on its profile, in whole US dollars. |
| `companyLastFundingRoundType` | string | no | The type of the current company's last funding round, such as `Series A`. |
| `companyLastFundingAmount` | integer (int64) | no | The amount of the current company's last funding round, in whole US dollars. |
| `companyFundingTotalUsd` | integer (int64) | no | The current company's total funding raised, in whole US dollars. |
| `companyLastFundedAt` | string | no | The date of the current company's latest funding round, as `yyyy-MM-dd`. |
| `companySpecialties` | array of string | no | The current company's specialties. |
| `companyWebTechnologies` | array of SearchPersonWebTechnology | no | The web technologies the current company uses. Null when the web technology filters are off or it has none. |
| `seniorityLevel` | string | no | The seniority of the person's current role, such as `Director` or `CLevel`. |
| `seniorityConfidence` | number (double) | no | How sure Kenso is of `seniorityLevel`, from 0 to 1. Absent with `view=summary`. |
| `function` | string | no | The function of the person's current role, such as `Sales` or `Engineering`. |
| `isDecisionMaker` | boolean | no | True when the person's seniority is Director, VP, CLevel, Partner or Owner. |
| `yearsOfExperience` | number (double) | no | The person's years of work experience. |
| `yearsInCurrentRole` | number (double) | no | The years the person has held their current role. |
| `yearsInCurrentCompany` | number (double) | no | The years the person has worked at their current company. |
| `skills` | array of string | no | The skills on the person's profile. |
| `languages` | array of string | no | The languages the person speaks. |
| `regions` | array of string | no | The regions the person's location belongs to. |
| `certifications` | array of SearchPersonCertification | no | The person's certifications. |
| `changedJobRecently` | boolean | no | True when the person started at a new company within the last 90 days, after leaving another. |
| `newInSeat` | boolean | no | True when the person joined their current company within the last 90 days, or the search's window. |
| `newInRole` | boolean | no | True when the person started their current role within the last 90 days, or the search's window. |
| `tenureRipe` | boolean | no | True when the person has held their current role for 3.5 years or more, or the search's threshold. |
| `jobChangeDate` | string | no | When the person started at their new company, set with `changedJobRecently`. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `titleChangedRecently` | boolean | no | True when the person's job title changed recently. |
| `promoted` | boolean | no | True when the person's recent title change was a promotion. |
| `seniorityIncreased` | boolean | no | True when the person's seniority went up with their recent title change. |
| `previousTitle` | string | no | The person's job title before their recent title change. |
| `previousSeniorityLevel` | string | no | The person's seniority before their recent title change. |
| `titleChangeDetectedMonth` | string | no | The month Kenso saw the person's title change, as the first day of that month. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `previousCompanyName` | string | no | The company the person worked at before their recent company change. |
| `jobChangeDetectedMonth` | string | no | The month Kenso saw the person's company change, as the first day of that month. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `createdAt` | string | no | When the profile was first added to the index. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `checkedAt` | string | no | When the profile was last checked. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `experience` | array of SearchPersonExperience | no | The person's work history, current positions first, then newest first. |
| `education` | array of SearchPersonEducation | no | The person's education. |
| `awards` | array of SearchPersonAward | no | The person's awards. |
| `organizations` | array of SearchPersonOrganization | no | The organizations the person belongs to. |
| `recommendations` | array of SearchPersonRecommendation | no | The recommendations others wrote for the person. |
| `publications` | array of SearchPersonPublication | no | The person's publications. |
| `patents` | array of SearchPersonPatent | no | The person's patents. |
| `volunteering` | array of SearchPersonVolunteering | no | The person's volunteering roles. |
| `websites` | array of SearchPersonWebsite | no | The websites on the person's profile. |
| `activity` | array of SearchPersonActivity | no | The person's recent LinkedIn activity. |
| `courseSuggestions` | array of SearchPersonCourseSuggestion | no | The courses LinkedIn suggests on the person's profile. |
| `similarProfiles` | array of SearchPersonSimilarProfile | no | Profiles LinkedIn shows as similar to this one. |
| `alsoViewed` | array of SearchPersonSimilarProfile | no | Profiles that people who viewed this one also viewed. |
| `othersNamed` | array of SearchPersonSimilarProfile | no | Other profiles with the same name. |
| `courses` | array of SearchPersonCourse | no | The courses the person took. |
| `groups` | array of SearchPersonGroup | no | The LinkedIn groups the person belongs to. |
| `interests` | array of SearchPersonInterest | no | The person's interests. |
| `projects` | array of SearchPersonProject | no | The person's projects. |
| `testScores` | array of SearchPersonTestScore | no | The person's test scores. |
| `hiddenDetails` | array of string | no | The names of the profile details the person hides. |
| `volunteeringCares` | array of string | no | The causes the person cares about, from the volunteering section of their profile. |
| `volunteeringOpportunities` | array of string | no | The volunteering opportunities the person is open to. |
| `volunteeringSupports` | array of string | no | The organizations the person supports, from the volunteering section of their profile. |
| `postsSeeMoreUrls` | array of string | no | Links to more of the person's posts. |
| `relevanceScore` | number (double) | no | How well the person matches the search, higher first. 0 when the answer is not a search. |
| `lookalike` | SearchPersonLookalikeMatch | no | How much the person's current company looks like the lookalike seeds. Present only on a lookalike search. |
| `matchedCurrentRole` | SearchPersonMatchedRole | no | The current role that matched a title search when `currentTitle` does not. Present only on a title search. |
| `hasKenEmail` | boolean | no | True when Kenso holds a verified email for the person, so importing them needs no email find. |
| `kenEmailStatus` | string | no | The best email Kenso holds for the person: `none`, `risky`, `catch_all` or `verified`. |
| `searchToken` | string | no | The token a `source: search` import counts the person by. Absent when the person has no LinkedIn URL. |
| `behaviorTags` | array of string | no | The workspace's behavior tags for the person. Present only on a people search with the `behavior_signals` feature. |

### SearchPeopleFacets

How many people match each value of the main filters, most first.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `industries` | array of SearchPeopleFacetBucket | no | The counts by industry. |
| `seniorityLevels` | array of SearchPeopleFacetBucket | no | The counts by seniority level. |
| `functions` | array of SearchPeopleFacetBucket | no | The counts by job function. |
| `countries` | array of SearchPeopleFacetBucket | no | The counts by country. |
| `states` | array of SearchPeopleFacetBucket | no | The counts by state or region. |
| `cities` | array of SearchPeopleFacetBucket | no | The counts by city. |
| `companyTypes` | array of SearchPeopleFacetBucket | no | The counts by company type. |
| `companySizes` | array of SearchPeopleFacetBucket | no | The counts by company size. |
| `fundingRoundTypes` | array of SearchPeopleFacetBucket | no | The counts by the type of the company's last funding round. |
| `webTech` | array of SearchPeopleFacetBucket | no | Always null for people: only company facets count web technologies. |
| `webTechCategories` | array of SearchPeopleFacetBucket | no | Always null for people: only company facets count web technology categories. |

### SearchPeopleLookalikeSeeds

How the seeds of a lookalike filter resolved.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `resolved` | array of SearchPeopleResolvedSeed | no | The seeds Kenso found. |
| `unresolved` | array of SearchPeopleUnresolvedSeed | no | The seeds Kenso could not use, with the reason. |

### SearchPersonWebTechnology

A web technology a company uses.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `key` | string | no | The technology's key, as the web technology filters take it. |
| `name` | string | no | The technology's display name. |

### SearchPersonCertification

One certification a person holds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The certification's name. |
| `issuer` | string | no | Who issued the certification. |
| `credentialId` | string | no | The credential id. |
| `certificateUrl` | string | no | The URL of the certificate. |
| `certificateLogoUrl` | string | no | The URL of the certificate's logo. |
| `issuerUrl` | string | no | The URL of the issuer's page. |
| `startDate` | string | no | When the certification was issued. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `endDate` | string | no | When the certification expires. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchPersonExperience

One position in a person's work history.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `companyId` | integer (int64) | no | The Search id of the position's company. |
| `companyName` | string | no | The name of the position's company. |
| `companyUrl` | string | no | The URL of the company's LinkedIn page. |
| `companyLogoUrl` | string | no | The URL of the company's logo. |
| `title` | string | no | The position's job title. |
| `location` | string | no | Where the position is. |
| `isCurrent` | boolean | no | True when the person holds the position now. |
| `startDate` | string | no | When the position started. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `endDate` | string | no | When the position ended. Null for a current position. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `durationMonths` | integer (int32) | no | How long the position lasted, in months. |
| `seniorityLevel` | string | no | The position's seniority. |
| `description` | string | no | The position's description. |

### SearchPersonEducation

One school a person attended.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `schoolName` | string | no | The school's name. |
| `degree` | string | no | The degree. |
| `fieldOfStudy` | string | no | The field of study. |
| `schoolUrl` | string | no | The URL of the school's LinkedIn page. |
| `schoolLogoUrl` | string | no | The URL of the school's logo. |
| `description` | string | no | The description of the studies. |
| `activitiesAndSocieties` | string | no | The activities and societies the person took part in. |
| `startDate` | string | no | When the studies started. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `endDate` | string | no | When the studies ended. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchPersonAward

One award a person received.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The award's name. |
| `issuer` | string | no | Who gave the award. |
| `description` | string | no | The award's description. |
| `date` | string | no | When the person received the award, as the profile writes it. |

### SearchPersonOrganization

One organization a person belongs to.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | The organization's name. |
| `position` | string | no | The person's position in the organization. |
| `description` | string | no | The description of the membership. |
| `startDate` | string | no | When the membership started. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `endDate` | string | no | When the membership ended. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchPersonRecommendation

A recommendation someone wrote for a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | string | no | The recommendation's text. |
| `recommenderName` | string | no | The name of the person who wrote it. |
| `recommenderUrl` | string | no | The LinkedIn profile URL of the person who wrote it. |

### SearchPersonPublication

One publication of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The publication's title. |
| `publisher` | string | no | The publisher. |
| `description` | string | no | The publication's description. |
| `url` | string | no | The publication's URL. |
| `authors` | array of SearchPersonContributor | no | The publication's authors. |
| `date` | string | no | When the publication came out. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchPersonPatent

One patent of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The patent's title. |
| `description` | string | no | The patent's description. |
| `patentNumber` | string | no | The patent or application number. |
| `url` | string | no | The patent's URL. |
| `status` | string | no | The patent's status, such as issued or pending. |
| `inventors` | array of SearchPersonContributor | no | The patent's inventors. |
| `date` | string | no | When the patent was issued or filed. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchPersonVolunteering

One volunteering role of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `organization` | string | no | The organization's name. |
| `role` | string | no | The person's role. |
| `cause` | string | no | The cause the role serves. |
| `description` | string | no | The role's description. |
| `startDate` | string | no | When the role started. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `endDate` | string | no | When the role ended. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchPersonWebsite

A website on a person's profile.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | no | The website's URL. |

### SearchPersonActivity

One recent LinkedIn activity of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `activityUrl` | string | no | The URL of the post. |
| `title` | string | no | The post's title or first words. |
| `action` | string | no | What the person did, such as posting or liking. |

### SearchPersonCourseSuggestion

A course LinkedIn suggests on a person's profile.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The course's title. |
| `courseUrl` | string | no | The course's URL. |

### SearchPersonSimilarProfile

A profile LinkedIn shows next to a person's profile.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `profileUrl` | string | no | The profile's URL. |
| `fullName` | string | no | The profile's full name. |
| `headline` | string | no | The profile's headline. |
| `location` | string | no | Where the profile's person is. |
| `company` | string | no | The profile's company. |
| `followers` | integer (int32) | no | How many followers the profile has. |

### SearchPersonCourse

A course a person took.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The course's title. |
| `number` | string | no | The course's number. |

### SearchPersonGroup

A LinkedIn group a person belongs to.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | The group's name. |
| `url` | string | no | The group's URL. |

### SearchPersonInterest

An interest of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | The interest's name. |

### SearchPersonProject

A project of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The project's title. |
| `description` | string | no | The project's description. |
| `url` | string | no | The project's URL. |
| `startDate` | string | no | When the project started. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `endDate` | string | no | When the project ended. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `teamMembers` | array of SearchPersonContributor | no | The project's team members. |

### SearchPersonTestScore

A test score of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The test's name. |
| `score` | string | no | The score, as the profile writes it. |
| `description` | string | no | The description of the test. |
| `date` | string | no | When the person took the test. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchPersonLookalikeMatch

A row's similarity to the lookalike seeds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `score` | integer (int32) | no | The similarity score, from 0 to 100. |
| `grade` | integer (int32) | no | The similarity grade, from 1 to 5, where 5 is the closest. |

### SearchPersonMatchedRole

One current role of a person.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The role's job title. |
| `companyName` | string | no | The name of the role's company. |
| `companyId` | integer (int64) | no | The Search id of the role's company. |

### SearchPeopleFacetBucket

One filter value and how many results carry it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `value` | string | no | The filter value, as the filter takes it. |
| `count` | integer (int64) | no | How many results carry the value. |
| `label` | string | no | The display name when the value is a key, as on the web technology facets. Null otherwise. |

### SearchPeopleResolvedSeed

A lookalike seed Kenso found.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `input` | string | no | The seed as you sent it. A text seed is cut to 80 characters. |
| `companyId` | integer (int64) | no | The Search id of the company the seed resolved to. |
| `personId` | integer (int64) | no | The Search id of the person the seed resolved to, for a person seed. |
| `name` | string | no | The name of the company or person the seed resolved to. |
| `domain` | string | no | The domain of the company the seed resolved to. |

### SearchPeopleUnresolvedSeed

A lookalike seed Kenso could not use.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `input` | string | no | The seed as you sent it. |
| `reason` | string | no | Why the seed was not used: `not_found`, `no_text`, `embedding_unavailable` or `not_b2b_excluded`. |

### SearchPersonContributor

A person named on a publication, patent or project.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `fullName` | string | no | The person's full name. |
| `profileUrl` | string | no | The person's LinkedIn profile URL. |
