> 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: Get the sample 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.

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

## Get the sample search

`GET /v1/search/sample` - operationId `search.get-sample`

| Permission | Rate limit |
| --- | --- |
| Search view | 12,000 requests a minute per API key |

Get a ready-made sample search for this workspace. Ken picks one search from the workspace's ideal customer
profile (ICP) and runs it for people, companies, job posts and funding, so a new workspace sees real results
before it builds its own search.

The call answers at once and never waits for a build. `status` is one of:

- `ready`: the sample is in the answer. `refreshing` is true while Kenso rebuilds it because the ICP
changed or the sample expired.
- `pending`: there is no sample yet and a build is queued or running. Poll again in about 5 seconds.
- `unavailable`: the workspace has no ICP context yet, the workspace used its 6 builds of the day with no
sample to serve, or the last build for this ICP failed. Kenso retries a failed build after 10 minutes when a
service was down, and after 6 hours when the search found nothing.
- `off`: the `search_sample` feature is off for the workspace, and nothing runs.

A ready sample holds `query`, the filters Ken picked, and four tabs. `profiles` and `companies`
hold the `request` sent and the `page` that `POST /v1/search/people` or
`POST /v1/search/companies` returned for it. `jobs` holds the `request` (`jobFilters` and
`peopleFilters`) and the `companies` and `people` pages the job post searches returned.
`funding` holds the `request` (`signalType` and `parameters`) and the `page` that
`POST /v1/triggers/preview` returned. A tab is absent when its search failed or found nothing.

Kenso keeps a sample for 7 days, or 10 minutes when a tab failed during an outage. It rebuilds the sample, at most
6 times a day, when the workspace's website, company context or ICP knowledge file changes. The sample is free:
it costs no credits, does not count against `searchBrowseRows`, and never becomes a saved search or list.

Errors:

- `503 service_unavailable`: Kenso could not read the sample. Try again.

Requires Search view.

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

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

| Field | Type | Description |
| --- | --- | --- |
| `status` | string | The sample's state: `ready`, `pending`, `unavailable` or `off`. |
| `refreshing` | boolean | True while Kenso rebuilds the sample, because the ICP changed or the sample expired. |
| `generatedAt` | string (date-time) | When Kenso built this sample, UTC. |
| `expiresAt` | string (date-time) | When this sample expires and Kenso rebuilds it, UTC. |
| `query` | SearchSampleQuery | The filters Ken picked. Every tab ran its search from them. |
| `profiles` | SearchSampleProfilesTab | People: `page` is what `POST /v1/search/people` returned for `request`. |
| `companies` | SearchSampleCompaniesTab | Companies: `page` is what `POST /v1/search/companies` returned for `request`. |
| `jobs` | SearchSampleJobsTab | Job posts: what `POST /v1/job-post-searches/companies` and `POST /v1/job-post-searches/people` returned. |
| `funding` | SearchSampleFundingTab | Funding: `page` is what `POST /v1/triggers/preview` returned for `request`. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/search/sample" \
  -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": {
    "status": "ready",
    "refreshing": true,
    "generatedAt": "2026-09-23T15:02:11Z",
    "expiresAt": "2026-09-23T15:02:11Z",
    "query": {
      "titles": [
        "string"
      ],
      "seniorityLevels": [
        "string"
      ],
      "industries": [
        "string"
      ],
      "headcountMin": 1,
      "headcountMax": 1,
      "countries": [
        "string"
      ],
      "hiringTitles": [
        "string"
      ],
      "fundingMinRaisedUsd": 1,
      "fundingRaisedWithinDays": 1,
      "fundingIndustryGroups": [
        "string"
      ]
    },
    "profiles": {
      "request": {
        "currentTitles": [
          "string"
        ],
        "seniorityLevels": [
          "string"
        ],
        "industries": [
          "string"
        ],
        "companyHeadcount": {
          "min": 1,
          "max": 1
        },
        "countries": [
          "string"
        ],
        "page": 1,
        "pageSize": 1,
        "sortBy": "string"
      },
      "page": {
        "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": [],
            "companyWebTechnologies": [],
            "seniorityLevel": "Director",
            "seniorityConfidence": 0.5,
            "function": "Sales",
            "isDecisionMaker": true,
            "yearsOfExperience": 0.5,
            "yearsInCurrentRole": 0.5,
            "yearsInCurrentCompany": 0.5,
            "skills": [],
            "languages": [],
            "regions": [],
            "certifications": [],
            "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": [],
            "education": [],
            "awards": [],
            "organizations": [],
            "recommendations": [],
            "publications": [],
            "patents": [],
            "volunteering": [],
            "websites": [],
            "activity": [],
            "courseSuggestions": [],
            "similarProfiles": [],
            "alsoViewed": [],
            "othersNamed": [],
            "courses": [],
            "groups": [],
            "interests": [],
            "projects": [],
            "testScores": [],
            "hiddenDetails": [],
            "volunteeringCares": [],
            "volunteeringOpportunities": [],
            "volunteeringSupports": [],
            "postsSeeMoreUrls": [],
            "relevanceScore": 0.5,
            "lookalike": {},
            "matchedCurrentRole": {},
            "hasKenEmail": true,
            "kenEmailStatus": "none",
            "searchToken": "string",
            "behaviorTags": []
          }
        ],
        "facets": {
          "industries": [
            {}
          ],
          "seniorityLevels": [
            {}
          ],
          "functions": [
            {}
          ],
          "countries": [
            {}
          ],
          "states": [
            {}
          ],
          "cities": [
            {}
          ],
          "companyTypes": [
            {}
          ],
          "companySizes": [
            {}
          ],
          "fundingRoundTypes": [
            {}
          ],
          "webTech": [
            {}
          ],
          "webTechCategories": [
            {}
          ]
        },
        "dataAsOf": "string",
        "lookalikeSeeds": {
          "resolved": [
            {}
          ],
          "unresolved": [
            {}
          ]
        }
      }
    },
    "companies": {
      "request": {
        "industries": [
          "string"
        ],
        "countries": [
          "string"
        ],
        "employeesCount": {
          "min": 1,
          "max": 1
        },
        "excludeCompanyTypes": [
          "string"
        ],
        "page": 1,
        "pageSize": 1,
        "sortBy": "string",
        "sortOrder": "string"
      },
      "page": {
        "totalResults": 1,
        "page": 1,
        "pageSize": 1,
        "searchAfter": "string",
        "hasMore": true,
        "results": [
          {
            "kenId": 812,
            "name": "string",
            "website": "https://example.com",
            "domain": "acme.com",
            "industry": "string",
            "size": "51-200",
            "employeesCount": 1,
            "crossedSizeBandUp": true,
            "enteredSizeBand": "string",
            "headcountDeclined": true,
            "headcountDeclineAbs": 1,
            "headcountDeclinePct": 0.5,
            "headcountDeclineMonth": "string",
            "description": "string",
            "type": "string",
            "founded": 1,
            "linkedInUrl": "https://example.com",
            "logoUrl": "https://example.com",
            "followers": 1,
            "headquartersLocation": "string",
            "headquartersCountry": "string",
            "headquartersCity": "string",
            "headquartersState": "string",
            "headquartersCountryIso2": "US",
            "locations": [],
            "specialties": [],
            "lastFundingRoundType": "string",
            "lastFundingAmount": 1,
            "lastFundingRoundAnnouncedDate": "2021-03-01T00:00:00",
            "raisedFundingRecently": true,
            "totalFunding": 1,
            "fundingTotalUsd": 1,
            "lastFundedAt": "string",
            "totalRoundsCount": 1,
            "lastRoundInvestorsCount": 1,
            "fundingRounds": [],
            "similarCompanies": [],
            "leadershipChanges": [],
            "hiringSurges": [],
            "headcountGrew": true,
            "employeesCountPrevious": 1,
            "headcountGrowthAbs": 1,
            "headcountGrowthPct": 0.5,
            "headcountGrowthDetectedAt": "2021-03-01T00:00:00",
            "headcountGrowthMonth": "string",
            "webTechnologies": [],
            "relevanceScore": 0.5,
            "lookalike": {}
          }
        ],
        "facets": {
          "industries": [
            {}
          ],
          "seniorityLevels": [
            {}
          ],
          "functions": [
            {}
          ],
          "countries": [
            {}
          ],
          "states": [
            {}
          ],
          "cities": [
            {}
          ],
          "companyTypes": [
            {}
          ],
          "companySizes": [
            {}
          ],
          "fundingRoundTypes": [
            {}
          ],
          "webTech": [
            {}
          ],
          "webTechCategories": [
            {}
          ]
        },
        "lookalikeSeeds": {
          "resolved": [
            {}
          ],
          "unresolved": [
            {}
          ]
        }
      }
    },
    "jobs": {
      "request": {
        "jobFilters": {
          "titles": {
            "include": []
          },
          "status": "string",
          "limit": 1,
          "location": {
            "countries": []
          }
        },
        "peopleFilters": {
          "page": 1,
          "pageSize": 1,
          "currentTitles": [
            "string"
          ],
          "seniorityLevels": [
            "string"
          ]
        }
      },
      "companies": {
        "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": []
          }
        ],
        "total": 1,
        "unmatched_total": 1,
        "pagination": {
          "next_cursor": "eyJpZCI6ODE1fQ"
        },
        "hiringSet": {
          "total": 1,
          "truncated": true,
          "unmatched": 1
        }
      },
      "people": {
        "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": [],
            "companyWebTechnologies": [],
            "seniorityLevel": "Director",
            "seniorityConfidence": 0.5,
            "function": "Sales",
            "isDecisionMaker": true,
            "yearsOfExperience": 0.5,
            "yearsInCurrentRole": 0.5,
            "yearsInCurrentCompany": 0.5,
            "skills": [],
            "languages": [],
            "regions": [],
            "certifications": [],
            "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": [],
            "education": [],
            "awards": [],
            "organizations": [],
            "recommendations": [],
            "publications": [],
            "patents": [],
            "volunteering": [],
            "websites": [],
            "activity": [],
            "courseSuggestions": [],
            "similarProfiles": [],
            "alsoViewed": [],
            "othersNamed": [],
            "courses": [],
            "groups": [],
            "interests": [],
            "projects": [],
            "testScores": [],
            "hiddenDetails": [],
            "volunteeringCares": [],
            "volunteeringOpportunities": [],
            "volunteeringSupports": [],
            "postsSeeMoreUrls": [],
            "relevanceScore": 0.5,
            "lookalike": {},
            "matchedCurrentRole": {},
            "jobPost": {}
          }
        ],
        "facets": {
          "industries": [
            {}
          ],
          "seniorityLevels": [
            {}
          ],
          "functions": [
            {}
          ],
          "countries": [
            {}
          ],
          "states": [
            {}
          ],
          "cities": [
            {}
          ],
          "companyTypes": [
            {}
          ],
          "companySizes": [
            {}
          ],
          "fundingRoundTypes": [
            {}
          ],
          "webTech": [
            {}
          ],
          "webTechCategories": [
            {}
          ]
        },
        "dataAsOf": "string",
        "lookalikeSeeds": {
          "resolved": [
            {}
          ],
          "unresolved": [
            {}
          ]
        },
        "hiringSet": {
          "count": 1,
          "truncated": true
        },
        "companies": [
          {
            "companyId": 812,
            "totalResults": 1
          }
        ]
      }
    },
    "funding": {
      "request": {
        "signalType": "string",
        "parameters": {
          "raisedWithinDays": 1,
          "minRaisedUsd": 1,
          "industryGroups": [
            "string"
          ],
          "states": [
            "string"
          ]
        }
      },
      "page": {
        "signalType": "open_roles",
        "month": "string",
        "companies": [
          {
            "kenCompanyId": 812,
            "companyId": 812,
            "name": "string",
            "domain": "acme.com",
            "linkedinUrl": "https://example.com",
            "openJobCount": 1,
            "jobs": [],
            "previousHeadcount": 1,
            "currentHeadcount": 1,
            "growthAbs": 1,
            "growthPct": 0.5,
            "websiteUrl": "https://example.com",
            "city": "string",
            "state": "string",
            "industry": "string",
            "revenueRange": "string",
            "foundedYear": 1,
            "totalRaisedUsd": 1,
            "raises": [],
            "executives": []
          }
        ],
        "total": 1,
        "totalIsCapped": true,
        "steps": [
          {
            "name": "string",
            "count": 1,
            "description": "string"
          }
        ],
        "estimatedCredits": {
          "isEstimate": true,
          "leads": 1,
          "totalMillicredits": 1,
          "credits": 0.5,
          "lines": [
            {}
          ],
          "basis": "string"
        },
        "pagination": {
          "nextCursor": "eyJpZCI6ODE1fQ",
          "hasMore": true
        }
      }
    }
  }
}
```

## Types

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

### SearchSampleQuery

The search Ken picked from the workspace's ideal customer profile. Each sample tab ran its own search from these filters, so you can copy them into your own search.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `titles` | array of string | no | Job titles of the people to reach, up to 6. |
| `seniorityLevels` | array of string | no | Seniority levels, from the ones the Search page offers: `Entry`, `Individual`, `Senior`, `Manager`, `Director`, `VP`, `CLevel` and `Owner`. |
| `industries` | array of string | no | Industries, as Search names them in lowercase, up to 5. |
| `headcountMin` | integer (int32) | no | The smallest company headcount. Null for no minimum. |
| `headcountMax` | integer (int32) | no | The largest company headcount. Null for no maximum. |
| `countries` | array of string | no | Country names in English, from United States, Canada, United Kingdom, Ireland, Australia and New Zealand. |
| `hiringTitles` | array of string | no | Job titles a company would hire for when it needs what the workspace sells, up to 5. |
| `fundingMinRaisedUsd` | integer (int64) | no | The smallest amount raised, in whole US dollars. Null for any amount. |
| `fundingRaisedWithinDays` | integer (int32) | no | How recent the funding must be, in days: 30, 90, 180 or 365. |
| `fundingIndustryGroups` | array of string | no | Industry groups for the funding search, from the ones the Search page's funding filter offers, up to 5. |

### SearchSampleProfilesTab

The people tab of the sample: the people search it ran and the page that search returned.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `request` | SearchSampleProfilesRequest | no | The `POST /v1/search/people` body the tab sent, built from the sample's `query`. |
| `page` | SearchPeopleResults | no | The page the people search returned, cut to the people the sample shows, a few per company: `page` is 1, `pageSize` is how many it kept, `hasMore` is false and `searchAfter` is absent. Its people carry no `hasKenEmail`, `kenEmailStatus`, `searchToken` or `behaviorTags`: Kenso adds those only to the answer of `POST /v1/search/people`. |

### SearchSampleCompaniesTab

The companies tab of the sample: the company search it ran and the page that search returned.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `request` | SearchSampleCompaniesRequest | no | The `POST /v1/search/companies` body the tab sent, built from the sample's `query`. |
| `page` | SearchCompaniesResults | no | The page the company search returned, cut to the companies the sample shows: those with a website or domain, most LinkedIn followers first. `page` is 1, `pageSize` is how many it kept, `hasMore` is false and `searchAfter` is absent. |

### SearchSampleJobsTab

The job posts tab of the sample.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `request` | SearchSampleJobsRequest | no | The request: `jobFilters` and `peopleFilters`. |
| `companies` | JobPostSearchCompanies | no | The page of companies hiring for the job filters. |
| `people` | JobPostSearchPeopleResults | no | The page of people at those companies. Absent when that search failed or found nobody. |

### SearchSampleFundingTab

The funding tab of the sample: the trigger preview it ran and the page that preview returned.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `request` | SearchSampleFundingRequest | no | The `POST /v1/triggers/preview` body the tab sent, built from the sample's `query`. |
| `page` | TriggerPreviewPage | no | The first page the trigger preview returned. |

### SearchSampleProfilesRequest

The people search the sample's people tab sent. A filter is absent when the sample's query has no value for it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `currentTitles` | array of string | no | The job titles to match, from `query.titles`. |
| `seniorityLevels` | array of string | no | The seniority levels to match, from `query.seniorityLevels`. |
| `industries` | array of string | no | The industries to match, from `query.industries`. |
| `companyHeadcount` | SearchSampleRange | no | The company headcount range, from `query.headcountMin` and `query.headcountMax`. |
| `countries` | array of string | no | The countries to match, by English name, from `query.countries`. |
| `page` | integer (int32) | no | The page number: always 1. |
| `pageSize` | integer (int32) | no | How many people the search asked for, before the sample cut the page. |
| `sortBy` | string | no | The sort: always `relevance`. |

### SearchPeopleResults

One page of a people search.

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

### SearchSampleCompaniesRequest

The company search the sample's companies tab sent. A filter is absent when the sample's query has no value for it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `industries` | array of string | no | The industries to match, from `query.industries`. |
| `countries` | array of string | no | The countries to match, by English name, from `query.countries`. |
| `employeesCount` | SearchSampleRange | no | The headcount range, from `query.headcountMin` and `query.headcountMax`. |
| `excludeCompanyTypes` | array of string | no | The company types left out: schools, nonprofits, government agencies and one-person pages. |
| `page` | integer (int32) | no | The page number: always 1. |
| `pageSize` | integer (int32) | no | How many companies the search asked for, before the sample cut the page. |
| `sortBy` | string | no | The sort: always `relevance`. |
| `sortOrder` | string | no | The sort order: always `desc`. |

### SearchCompaniesResults

One page of a company search.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `totalResults` | integer (int64) | no | How many companies match the search in all. |
| `page` | integer (int32) | no | The page number, from 1. |
| `pageSize` | integer (int32) | no | The most companies a page holds. |
| `searchAfter` | string | no | The cursor of the next page: send it back unchanged as `searchAfter`. Null when there is none. |
| `hasMore` | boolean | no | True when more companies match after this page. |
| `results` | array of SearchCompany | no | The companies on this page. |
| `facets` | SearchCompanyFacets | no | Always null here: `POST /v1/search/companies/facets` counts the filter values. |
| `lookalikeSeeds` | SearchPeopleLookalikeSeeds | no | How each lookalike seed resolved. Present only on a lookalike search. |

### SearchSampleJobsRequest

The job post searches the sample's job posts tab ran.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `jobFilters` | SearchSampleJobFilters | no | The `jobFilters` sent to `POST /v1/job-post-searches/companies` and `POST /v1/job-post-searches/people`. |
| `peopleFilters` | SearchSampleJobPeopleFilters | no | The `peopleFilters` sent to `POST /v1/job-post-searches/people`. |

### JobPostSearchCompanies

One page of the companies hiring for the job filters, newest posting first.

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

### JobPostSearchPeopleResults

One page of people at the companies hiring for the job filters.

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

### SearchSampleFundingRequest

The trigger preview the sample's funding tab sent.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `signalType` | string | no | The signal type: always `fundraising`. |
| `parameters` | SearchSampleFundingParameters | no | The fundraising trigger's parameters. |

### TriggerPreviewPage

One page of a trigger preview: sample companies that would match, how many pass each filter step, and an estimated credit cost. The fields present depend on `signalType`. Kenso may add fields to it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `signalType` | string | no | The previewed signal type: `open_roles` or `company_headcount_growth`. Left out for `fundraising`. |
| `month` | string | no | The month of the headcount data, as `yyyy-MM`. Present only for `company_headcount_growth`. |
| `companies` | array of TriggerPreviewCompany | no | Sample matching companies on this page. |
| `total` | integer (int64) | no | The matching companies across all pages. Null for `open_roles`. For `fundraising` it stops at 1,000 (see `totalIsCapped`). |
| `totalIsCapped` | boolean | no | True when `total` stopped at 1,000, so more companies match. Present only for `fundraising`. |
| `steps` | array of TriggerPreviewStep | no | Each filter step on this page, in order, with how many companies or people pass it. The last step, `max_contacts_per_company`, is the most people the page can import. |
| `estimatedCredits` | TriggerPreviewCreditEstimate | no | The estimated lead credits for the people this page can import. Kenso charges nothing for a preview. |
| `pagination` | TriggerPreviewPagination | no | How to get the next page. |

### SearchSampleRange

A headcount range. A bound is absent when the sample's query has none.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `min` | integer (int32) | no | The smallest headcount. |
| `max` | integer (int32) | no | The largest headcount. |

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

### SearchCompany

A company in Kenso's company index, with its firmographics, funding and change signals.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kenId` | integer (int64) | no | The company's Search id. Send it as `companyId` to get the company again. |
| `name` | string | no | The company's name. |
| `website` | string | no | The company's website URL. |
| `domain` | string | no | The company's website domain, such as `acme.com`. |
| `industry` | string | no | The company's industry. |
| `size` | string | no | The company's size band by employee count, such as `51-200`, as the `companySizes` filter takes it. |
| `employeesCount` | integer (int32) | no | How many employees the company has. |
| `crossedSizeBandUp` | boolean | no | True when the company moved up into a bigger size band in the latest data delivery. |
| `enteredSizeBand` | string | no | The size band the company moved up into. Null when `crossedSizeBandUp` is false. |
| `headcountDeclined` | boolean | no | True when the company's headcount dropped in the latest data delivery. |
| `headcountDeclineAbs` | integer (int32) | no | How many employees the company lost. |
| `headcountDeclinePct` | number (double) | no | The headcount drop as a percentage of the earlier count, from 0 to 100. |
| `headcountDeclineMonth` | string | no | The month Kenso saw the drop, as `yyyy-MM`. |
| `description` | string | no | The company's description. |
| `type` | string | no | The company type, as the `companyTypes` filter takes it. |
| `founded` | integer (int32) | no | The year the company was founded. |
| `linkedInUrl` | string | no | The company's LinkedIn page URL. |
| `logoUrl` | string | no | The URL of the company's logo. |
| `followers` | integer (int32) | no | How many people follow the company on LinkedIn. |
| `headquartersLocation` | string | no | The headquarters as `city, state, country`, leaving out the parts Kenso does not know. |
| `headquartersCountry` | string | no | The country of the headquarters. |
| `headquartersCity` | string | no | The city of the headquarters. |
| `headquartersState` | string | no | The state or region of the headquarters. |
| `headquartersCountryIso2` | string | no | The country of the headquarters as an ISO 3166-1 alpha-2 code, such as `US`. |
| `locations` | array of SearchCompanyLocation | no | The company's offices. |
| `specialties` | array of string | no | The company's specialties. |
| `lastFundingRoundType` | string | no | The type of the company's last funding round, such as `Series A`. |
| `lastFundingAmount` | integer (int64) | no | The amount raised in the last funding round, in USD. |
| `lastFundingRoundAnnouncedDate` | string | no | When the last funding round was announced. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `raisedFundingRecently` | boolean | no | True when the company's latest raise is within the search's `raisedFundingWithinDays`, 180 by default. |
| `totalFunding` | integer (int64) | no | The total funding raised, in USD, as the data vendor reports it. |
| `fundingTotalUsd` | integer (int64) | no | The total funding raised, in whole USD: the larger of the known totals. The funding filters match on it. |
| `lastFundedAt` | string | no | The date of the latest funding raise, as `yyyy-MM-dd`. |
| `totalRoundsCount` | integer (int32) | no | How many funding rounds the company has had. |
| `lastRoundInvestorsCount` | integer (int32) | no | How many investors took part in the last funding round. |
| `fundingRounds` | array of SearchCompanyFundingRound | no | The company's funding rounds. |
| `similarCompanies` | array of integer (int64) | no | The Search ids of similar companies. |
| `leadershipChanges` | array of SearchCompanyLeadershipChange | no | The leadership changes that match the search's `leadershipChange` filter, newest first. Null without that filter. |
| `hiringSurges` | array of SearchCompanyHiringSurge | no | The job functions whose headcount grew, by month. |
| `headcountGrew` | boolean | no | True when the company's headcount grew in the latest data delivery. |
| `employeesCountPrevious` | integer (int32) | no | The headcount before the growth. |
| `headcountGrowthAbs` | integer (int32) | no | How many employees the company added. |
| `headcountGrowthPct` | number (double) | no | The headcount growth as a percentage of the earlier count, such as `12.5`. |
| `headcountGrowthDetectedAt` | string | no | When Kenso saw the growth. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `headcountGrowthMonth` | string | no | The month Kenso saw the growth, as `yyyy-MM`. |
| `webTechnologies` | array of SearchCompanyWebTechnology | no | The web technologies Kenso found for the company's domain. Null when it has none, or while the technology filters are off. |
| `relevanceScore` | number (double) | no | How well the company matches the search; higher is better. 0 outside a ranked search. |
| `lookalike` | SearchPersonLookalikeMatch | no | How much the company looks like the lookalike seeds. Present only on a lookalike search. |

### SearchCompanyFacets

How many companies 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 | Always null for companies: only people facets count seniority levels. |
| `functions` | array of SearchPeopleFacetBucket | no | Always null for companies: only people facets count job functions. |
| `countries` | array of SearchPeopleFacetBucket | no | The counts by headquarters country, with each country as an ISO 3166-1 alpha-2 code such as `US`. |
| `states` | array of SearchPeopleFacetBucket | no | Always null for companies: only people facets count states. |
| `cities` | array of SearchPeopleFacetBucket | no | Always null for companies: only people facets count cities. |
| `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 | The counts by web technology, with each technology's display name as `label`. Null while the technology filters are off. |
| `webTechCategories` | array of SearchPeopleFacetBucket | no | The counts by web technology category, with each category's display name as `label`. Null while the technology filters are off. |

### SearchSampleJobFilters

The job filters of the sample: open postings for the roles a buyer would hire for.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `titles` | SearchSampleJobTitles | no | The job titles to match, from `query.hiringTitles`. |
| `status` | string | no | The posting status: always `open`. |
| `limit` | integer (int32) | no | How many hiring companies the search read. |
| `location` | SearchSampleJobLocation | no | Where the jobs are. Absent when the sample's query names no country Kenso knows. |

### SearchSampleJobPeopleFilters

The people filters of the sample's job posts tab. A filter is absent when the sample's query has no value for it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer (int32) | no | The page number: always 1. |
| `pageSize` | integer (int32) | no | How many people the search asked for, before the sample cut the page. |
| `currentTitles` | array of string | no | The job titles to match, from `query.titles`. |
| `seniorityLevels` | array of string | no | The seniority levels to match, from `query.seniorityLevels`. |

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

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

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

### SearchSampleFundingParameters

The fundraising parameters of the sample's funding tab. A filter is absent when the sample's query has no value for it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `raisedWithinDays` | integer (int32) | no | How recent the funding must be, in days, from `query.fundingRaisedWithinDays`. |
| `minRaisedUsd` | integer (int64) | no | The smallest amount raised, in whole US dollars, from `query.fundingMinRaisedUsd`. |
| `industryGroups` | array of string | no | The industry groups to match, from `query.fundingIndustryGroups`. |
| `states` | array of string | no | Every US state and DC, as two-letter codes, when the sample's query names the United States: the funding index filters by an issuer's US state only. |

More types, defined in [the OpenAPI slice](/docs/api/search/openapi.json): `TriggerPreviewCompany`, `TriggerPreviewStep`, `TriggerPreviewCreditEstimate`, `TriggerPreviewPagination`, `SearchPersonWebTechnology`, `SearchPersonCertification`, `SearchPersonExperience`, `SearchPersonEducation`, `SearchPersonAward`, `SearchPersonOrganization`, `SearchPersonRecommendation`, `SearchPersonPublication`, `SearchPersonPatent`, `SearchPersonVolunteering`, `SearchPersonWebsite`, `SearchPersonActivity`, `SearchPersonCourseSuggestion`, `SearchPersonSimilarProfile`, `SearchPersonCourse`, `SearchPersonGroup`, `SearchPersonInterest`, `SearchPersonProject`, `SearchPersonTestScore`, `SearchPersonLookalikeMatch`, `SearchPersonMatchedRole`, `SearchPeopleFacetBucket`, `SearchPeopleResolvedSeed`, `SearchPeopleUnresolvedSeed`, `SearchCompanyLocation`, `SearchCompanyFundingRound`, `SearchCompanyLeadershipChange`, `SearchCompanyHiringSurge`, `SearchCompanyWebTechnology`, `SearchSampleJobTitles`, `SearchSampleJobLocation`, `JobPostSearchHiringJob`, `JobPostSearchOpenRole`, `TriggerPreviewJob`, `TriggerPreviewRaise`, `TriggerPreviewExecutive`, `TriggerPreviewCreditLine`, `SearchPersonContributor`.
