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

# Job post search

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

Find the companies and people behind job postings and import them.

Prospecting data. 4 endpoints under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/job-post-searches/openapi.json](/docs/api/job-post-searches/openapi.json).

- `POST /v1/job-post-searches/companies` - List hiring companies (`job-post-searches.companies`): [/docs/api/job-post-searches/companies.md](/docs/api/job-post-searches/companies.md)
- `POST /v1/job-post-searches/people` - Search people at hiring companies (`job-post-searches.people`): [/docs/api/job-post-searches/people.md](/docs/api/job-post-searches/people.md)
- `POST /v1/job-post-searches/people/count` - Count people at hiring companies (`job-post-searches.count`): [/docs/api/job-post-searches/count.md](/docs/api/job-post-searches/count.md)
- `POST /v1/job-post-searches/import` - Import people at hiring companies (`job-post-searches.import`): [/docs/api/job-post-searches/import.md](/docs/api/job-post-searches/import.md)

## List hiring companies

`POST /v1/job-post-searches/companies` - operationId `job-post-searches.companies`

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

List the companies hiring for your job filters, one page at a time. Use it to check the job filters before you
search for people.

Send `jobFilters`. Page through the companies with `jobFilters.limit` and `jobFilters.cursor`, set
to the previous page's `pagination.next_cursor`. Each company comes with its matching postings and
`match_count`. `hiringSet` describes the whole set: `total` companies and `truncated`.

By default the page lists only companies Kenso Search knows. Send `includeUnmatched: true` to also list the
hiring companies it has no record of, in the same order. Every row then has `match_status`,
`matched` or `unmatched`. An unmatched row has a null `ken_search_id`, the best-known
`domain` with its `domain_source`, and no people yet. The page's `total` counts both kinds and
`unmatched_total` counts the unmatched rows. `hiringSet.unmatched` counts the unmatched companies, while
`hiringSet.total` stays the matched companies that the people searches cover.

The call is free.

Errors:

- `400 validation_failed`: the body is not a JSON object, `jobFilters` is missing or not an object, or
`includeUnmatched` is not true or false.
- `402 plan_required`: the workspace's plan does not include job post search. `error.refusal` carries
the code `PLAN_FEATURE_NOT_AVAILABLE` and the feature `job_post_search`.
- `422 filter_required`: `jobFilters` sets no filter.
- `422 invalid_cursor`: `jobFilters.cursor` did not come from a previous page.
- `503 service_unavailable`: job postings are not available right now. Try again.

Requires Search view.

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

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

### Request body

`application/json`, optional: `object`.

### Response 200

`data` is a `JobPostSearchCompanies`.

| Field | Type | Description |
| --- | --- | --- |
| `companies` | array of JobPostSearchHiringCompany | The companies on this page. |
| `total` | integer (int64) | How many companies are hiring for the job filters in all. With `includeUnmatched` it counts the unmatched ones too. |
| `unmatched_total` | integer (int64) | How many of them Ken Search has no company for. Present only with `includeUnmatched`. |
| `pagination` | JobPostSearchPagination | Where the next page starts. |
| `hiringSet` | JobPostSearchCompaniesHiringSet | The whole set of hiring companies the people searches run on. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/job-post-searches/companies" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Example response

```json
{
  "success": true,
  "data": {
    "companies": [
      {
        "company_id": "string",
        "ken_search_id": "string",
        "match_status": "string",
        "name": "string",
        "domain": "acme.com",
        "domain_source": "ken_search",
        "match_count": 1,
        "newest_posted_at": "2026-09-23T15:02:11Z",
        "jobs": [
          {
            "id": "string",
            "title": "string",
            "location": "string",
            "application_url": "https://example.com",
            "posted_at": "2026-09-23T15:02:11Z"
          }
        ]
      }
    ],
    "total": 1,
    "unmatched_total": 1,
    "pagination": {
      "next_cursor": "eyJpZCI6ODE1fQ"
    },
    "hiringSet": {
      "total": 1,
      "truncated": true,
      "unmatched": 1
    }
  }
}
```

## Search people at hiring companies

`POST /v1/job-post-searches/people` - operationId `job-post-searches.people`

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

Search for people at the companies hiring for your job filters, and get one page of people. Use it to reach the
buyers at companies that are hiring for a role you sell into.

Send `jobFilters` and `peopleFilters`. Omit `peopleFilters` to match everyone at the hiring
companies. Kenso limits the search to the hiring set, so a company filter in `peopleFilters` has no effect.
Page with the `page` and `pageSize` fields of `peopleFilters`.

To get the people at each company of a hiring-companies page, send `companyIds`, up to 25
`ken_search_id` values from that page, and `perCompany`, from 1 to 50 people per company (3 when
omitted). Kenso then searches each company on its own, so a big company does not crowd out a small one. The
answer holds up to `perCompany` people at each company, in the order of `companyIds`, and
`companies`, with the `companyId` and `totalResults` of each company it searched. A company that is
not in the hiring set is not searched and not listed. `totalResults` adds up the companies' totals, and
paging does not apply.

The answer is a people search page, plus `hiringSet` (`count` companies and `truncated`). Each
person carries `jobPost`, the role their company is hiring for: `title`, `url`, `location`,
`postedAt`, `openRoles` and `moreRoles`. When no company is hiring, the page is empty. Each person on
the page counts against the workspace's daily `searchBrowseRows` quota.

Errors:

- `400 validation_failed`: the body is not a JSON object, `jobFilters` is missing or not an object,
`peopleFilters` is not an object, `companyIds` is not a list of 1 to 25 ids, `perCompany` is not a
whole number from 1 to 50 or comes without `companyIds`, or Search refused the people filters.
- `401 unauthenticated`: the API key belongs to no member. The search runs as a member.
- `402 plan_required`: the workspace's plan does not include job post search. `error.refusal` carries
the code `PLAN_FEATURE_NOT_AVAILABLE` and the feature `job_post_search`.
- `402 plan_required`: `peopleFilters` needs funding signals, which the plan lacks (`error.refusal`).
- `403 forbidden`: Search refused a people filter for this member.
- `422 filter_required`: `jobFilters` sets no filter.
- `429 quota_exceeded`: the workspace used its daily `searchBrowseRows` quota.
- `503 service_unavailable`: job postings or Search are not available right now. Try again.

Requires Search view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/job-post-searches/POST/v1/job-post-searches/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`. |

### Request body

`application/json`, optional: `object`.

### Response 200

`data` is a `JobPostSearchPeopleResults`.

| Field | Type | Description |
| --- | --- | --- |
| `totalResults` | integer (int64) | How many people match in all. With `companyIds`, the companies' totals added up. |
| `page` | integer (int32) | The page number, from 1. Absent when no company is hiring. |
| `pageSize` | integer (int32) | The most people a page holds; with `companyIds`, the most people per company. Absent when no company is hiring. |
| `searchAfter` | string | The cursor of the next page: send it back unchanged as `searchAfter` in `peopleFilters`. Null when there is none. |
| `hasMore` | boolean | True when more people match after this page. |
| `results` | array of JobPostSearchPerson | The people on this page. With `companyIds`, each company's people in the order of `companyIds`. |
| `facets` | SearchPeopleFacets | Always null here: the people search does not count filter values. |
| `dataAsOf` | string | The date of the newest profile check in the index, as `yyyy-MM-dd`. |
| `lookalikeSeeds` | SearchPeopleLookalikeSeeds | How each lookalike seed resolved. Present only when `peopleFilters` holds a lookalike filter. |
| `hiringSet` | JobPostSearchHiringSet | The hiring companies the search covered. |
| `companies` | array of JobPostSearchCompanyTotal | Each company searched, with its own total. Present only when the body sends `companyIds`. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/job-post-searches/people" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 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
        },
        "jobPost": {
          "title": "string",
          "url": "https://example.com",
          "location": "string",
          "postedAt": "2021-03-01T00:00:00",
          "openRoles": 1,
          "moreRoles": 1
        }
      }
    ],
    "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"
        }
      ]
    },
    "hiringSet": {
      "count": 1,
      "truncated": true
    },
    "companies": [
      {
        "companyId": 812,
        "totalResults": 1
      }
    ]
  }
}
```

## Count people at hiring companies

`POST /v1/job-post-searches/people/count` - operationId `job-post-searches.count`

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

Count the people at the companies hiring for your job filters, without returning them. Use it to size an import.

Send the same `jobFilters` and `peopleFilters` as `POST /v1/job-post-searches/people`. The answer
holds `totalResults` and `hiringSet`. Counting does not use the `searchBrowseRows` quota.

Errors:

- `400 validation_failed`: the body is not a JSON object, `jobFilters` is missing or not an object,
`peopleFilters` is not an object, or Search refused the people filters.
- `401 unauthenticated`: the API key belongs to no member.
- `402 plan_required`: the workspace's plan does not include job post search. `error.refusal` carries
the code `PLAN_FEATURE_NOT_AVAILABLE` and the feature `job_post_search`.
- `402 plan_required`: `peopleFilters` needs funding signals, which the plan lacks (`error.refusal`).
- `403 forbidden`: Search refused a people filter for this member.
- `422 filter_required`: `jobFilters` sets no filter.
- `503 service_unavailable`: job postings or Search are not available right now. Try again.

Requires Search view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/job-post-searches/POST/v1/job-post-searches/people/count)

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

### Request body

`application/json`, optional: `object`.

### Response 200

`data` is a `JobPostSearchPeopleCount`.

| Field | Type | Description |
| --- | --- | --- |
| `totalResults` | integer (int64) | How many people match the people filters at the hiring companies. |
| `hiringSet` | JobPostSearchHiringSet | The hiring companies the count covered. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/job-post-searches/people/count" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Example response

```json
{
  "success": true,
  "data": {
    "totalResults": 1,
    "hiringSet": {
      "count": 1,
      "truncated": true
    }
  }
}
```

## Import people at hiring companies

`POST /v1/job-post-searches/import` - operationId `job-post-searches.import`

| Permission | Rate limit |
| --- | --- |
| Campaigns edit and Search view and the `import` permission | 480 requests a minute per API key |

Add the people at the companies hiring for your job filters to a campaign as contacts. Each contact gets the
five hiring variables, filled from its company's newest matching posting and its number of matching postings.

Send `jobFilters`, `peopleFilters`, `campaignId` (required) and `importLimit`, a positive
whole number that caps how many people Kenso imports. A lookalike search cannot be imported this way.

The import runs in the background. The answer holds `jobId`: poll
`GET /v1/search/imports/{importId}` with it.

Errors:

- `400 validation_failed`: the body is not valid, `campaignId` is missing, `importLimit` is not a
positive whole number, or no company is hiring for the job filters (detail code `empty_hiring_set`).
- `400 lookalike_not_storable`: `peopleFilters` carries a lookalike filter.
- `400 validation_failed`: the workspace is a developer sandbox. A sandbox holds seeded and test data only,
so search imports are not available in it.
- `401 unauthenticated`: the API key belongs to no member. An import runs as a member.
- `402 plan_required`: the workspace's plan does not include job post search. `error.refusal` carries
the code `PLAN_FEATURE_NOT_AVAILABLE` and the feature `job_post_search`.
- `402 plan_required`: `peopleFilters` needs funding signals, which the plan lacks (`error.refusal`).
- `403 forbidden`: Search refused the import for this member.
- `404 not_found`: the campaign is not in this workspace.
- `422 filter_required`: `jobFilters` sets no filter.
- `503 service_unavailable`: job postings or Search are not available right now. Try again.

Requires Campaigns edit and the `import` permission, plus Search view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/job-post-searches/POST/v1/job-post-searches/import)

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

### Request body

`application/json`, optional: `object`.

### Response 200

`data` is a `JobPostSearchImportResult`.

| Field | Type | Description |
| --- | --- | --- |
| `jobId` | integer (int64) | The import's id. Poll `GET /v1/search/imports/{importId}` with it. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/job-post-searches/import" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Example response

```json
{
  "success": true,
  "data": {
    "jobId": 812
  }
}
```

## Types

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

### JobPostSearchHiringCompany

A company hiring for the job filters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `company_id` | string | no | The job index's own id of the company, as a string. |
| `ken_search_id` | string | no | The company's Search id, as a string: send it in `companyIds` to search the people there. Null for a company Ken Search has no company for. |
| `match_status` | string | no | `matched` for a Ken Search company, `unmatched` otherwise. Present only with `includeUnmatched`. |
| `name` | string | no | The company's name. |
| `domain` | string | no | The company's domain, such as `acme.com`. |
| `domain_source` | string | no | Where `domain` came from: `ken_search`, `website`, `agent`, `job_post` or `clearbit`. Present only with `includeUnmatched`; null when there is no domain. |
| `match_count` | integer (int64) | no | How many of the company's open jobs match the job filters. |
| `newest_posted_at` | string (date-time) | no | When the company's newest matching job was posted, or first seen when the posting has no date. |
| `jobs` | array of JobPostSearchHiringJob | no | Up to 5 of the company's newest matching jobs. |

### JobPostSearchPagination

Where the next page of hiring companies starts.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `next_cursor` | string | no | The cursor of the next page: send it back unchanged as `jobFilters.cursor` with the same filters. Null on the last page. |

### JobPostSearchCompaniesHiringSet

The whole set of companies hiring for the job filters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `total` | integer (int64) | no | How many Ken Search companies are hiring for the job filters: the companies the people searches cover. |
| `truncated` | boolean | no | True when more companies matched than the 25,000 the set holds. |
| `unmatched` | integer (int64) | no | How many hiring companies Ken Search has no company for. Present only with `includeUnmatched`. |

### JobPostSearchHiringJob

An open job that matches the job filters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | The job's id, as a string. |
| `title` | string | no | The job title. |
| `location` | string | no | Where the job is, as the posting writes it. |
| `application_url` | string | no | The URL to apply for the job. |
| `posted_at` | string (date-time) | no | When the job was posted, or first seen when the posting has no date. |

### JobPostSearchPerson

A person at a company that is hiring.

| 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. |
| `jobPost` | JobPostSearchOpenRole | no | The role the person's company is hiring for. Null when the company is not in the hiring set. |

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

### JobPostSearchHiringSet

The companies hiring for the job filters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | integer (int32) | no | How many hiring companies the search covered. With `companyIds`, the ones of them in the hiring set. |
| `truncated` | boolean | no | True when more companies matched the job filters than the 25,000 a hiring set holds. |

### JobPostSearchCompanyTotal

One company searched on its own, and how many people match there.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `companyId` | integer (int64) | no | The company's Search id, from `companyIds`. |
| `totalResults` | integer (int64) | no | How many people match at the company. |

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

### JobPostSearchOpenRole

The newest posting that matched the job filters at a company, and how many matched.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | no | The posting's job title. |
| `url` | string | no | The posting's URL. |
| `location` | string | no | Where the job is. |
| `postedAt` | string | no | When the job was posted. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `openRoles` | integer (int32) | no | How many of the company's postings match the job filters. |
| `moreRoles` | integer (int32) | no | How many matching postings the company has besides this one. |

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

All resources: [/docs.md](/docs.md).
