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

# Saved searches: Run a saved 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 [Saved searches](/docs/api/saved-searches.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Run a saved search

`POST /v1/saved-searches/{savedSearchId}/run` - operationId `saved-searches.run`

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

Run a people or company saved search with its saved filters and get the first page of results.

The answer holds `savedSearchId`, `searchType`, `totalResults` and `results`, the first 25
matches as a people or company search page. Each profile on the page counts against the workspace's daily
`searchBrowseRows` quota. A `JobPosts` saved search does not run here: send its `jobFilters` and
`peopleFilters` to `POST /v1/job-post-searches/people`.

Errors:

- `400 validation_failed`: the saved filters can no longer run, or the saved search is a `JobPosts`
search.
- `403 forbidden`: the saved search is not shared with you.
- `404 not_found`: no saved search has this id.
- `429 quota_exceeded`: the workspace used its daily `searchBrowseRows` quota.

Requires Search view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/saved-searches/POST/v1/saved-searches/%7BsavedSearchId%7D/run)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `savedSearchId` | path | integer (int64) | yes | The saved search's id. |
| `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

The body is a `SavedSearchRunPeopleResponse or SavedSearchRunCompaniesResponse`.

### Request

```bash
curl -X POST "https://api.ken.so/v1/saved-searches/812/run" \
  -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": {
    "savedSearchId": 812,
    "searchType": "People",
    "totalResults": 1,
    "results": {
      "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": [
            {}
          ],
          "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": [
            {}
          ],
          "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": [
            "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
          }
        }
      ],
      "facets": {
        "industries": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "seniorityLevels": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "functions": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "countries": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "states": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "cities": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "companyTypes": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "companySizes": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "fundingRoundTypes": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "webTech": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ],
        "webTechCategories": [
          {
            "value": "string",
            "count": 1,
            "label": "string"
          }
        ]
      },
      "dataAsOf": "string",
      "lookalikeSeeds": {
        "resolved": [
          {
            "input": "string",
            "companyId": 812,
            "personId": 812,
            "name": "string",
            "domain": "example.com"
          }
        ],
        "unresolved": [
          {
            "input": "string",
            "reason": "not_found"
          }
        ]
      }
    }
  }
}
```

## Types

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

### SavedSearchRunPeopleResponse

The body of a successful operation that returns one result. The result is in `data`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no | Always true on a success. |
| `data` | SavedSearchRunPeople | no | The result of the operation. |

### SavedSearchRunCompaniesResponse

The body of a successful operation that returns one result. The result is in `data`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no | Always true on a success. |
| `data` | SavedSearchRunCompanies | no | The result of the operation. |

### SavedSearchRunPeople

The first page of a people saved search, run with its saved filters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `savedSearchId` | integer (int64) | no | The saved search's id. |
| `searchType` | string, one of: People | no | The kind of saved search: `People`. |
| `totalResults` | integer (int64) | no | How many people match the saved filters in all. |
| `results` | SavedSearchRunPeoplePage | no | The first page of the people search, up to 25 people. |

### SavedSearchRunCompanies

The first page of a company saved search, run with its saved filters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `savedSearchId` | integer (int64) | no | The saved search's id. |
| `searchType` | string, one of: Account | no | The kind of saved search: `Account`, a company search. |
| `totalResults` | integer (int64) | no | How many companies match the saved filters in all. |
| `results` | SearchCompaniesResults | no | The first page of the company search, up to 25 companies. |

### SavedSearchRunPeoplePage

The first page of a people saved search.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `totalResults` | integer (int64) | no | How many people match the saved filters in all. |
| `page` | integer (int32) | no | The page number: always 1. |
| `pageSize` | integer (int32) | no | The most people the page holds: always 25. |
| `searchAfter` | string | no | The cursor of the next page. Null when there is none. |
| `hasMore` | boolean | no | True when more people match after this page. |
| `results` | array of SavedSearchRunPerson | 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`. |
| `lookalikeSeeds` | SearchPeopleLookalikeSeeds | no | How each lookalike seed resolved. Present only when the saved filters hold a lookalike filter. |

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

### SavedSearchRunPerson

A person on a saved search's first page, as Ken Search writes it.

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

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

### SearchPersonWebTechnology

A web technology a company uses.

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

### SearchPersonCertification

One certification a person holds.

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

### SearchPersonExperience

One position in a person's work history.

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

### SearchPersonEducation

One school a person attended.

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

### SearchPersonAward

One award a person received.

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

### SearchPersonOrganization

One organization a person belongs to.

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

### SearchPersonRecommendation

A recommendation someone wrote for a person.

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

### SearchPersonPublication

One publication of a person.

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

### SearchPersonPatent

One patent of a person.

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

### SearchPersonVolunteering

One volunteering role of a person.

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

### SearchPersonWebsite

A website on a person's profile.

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

### SearchPersonActivity

One recent LinkedIn activity of a person.

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

### SearchPersonCourseSuggestion

A course LinkedIn suggests on a person's profile.

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

### SearchPersonSimilarProfile

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

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

### SearchPersonCourse

A course a person took.

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

### SearchPersonGroup

A LinkedIn group a person belongs to.

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

### SearchPersonInterest

An interest of a person.

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

### SearchPersonProject

A project of a person.

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

### SearchPersonTestScore

A test score of a person.

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

### SearchPersonLookalikeMatch

A row's similarity to the lookalike seeds.

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

### SearchPersonMatchedRole

One current role of a person.

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

### SearchPeopleFacetBucket

One filter value and how many results carry it.

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

### SearchPeopleResolvedSeed

A lookalike seed Kenso found.

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

### SearchPeopleUnresolvedSeed

A lookalike seed Kenso could not use.

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

### SearchCompanyLocation

One of a company's offices.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | no | The office's country. |
| `city` | string | no | The office's city. |
| `state` | string | no | The office's state or region. |
| `isHeadquarters` | boolean | no | True for the headquarters. |

### SearchCompanyFundingRound

One funding round of a company.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `roundType` | string | no | The round type, such as `Series A`. |
| `moneyRaised` | integer (int64) | no | The amount raised, in USD. |
| `announcedDate` | string | no | When the round was announced. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |

### SearchCompanyLeadershipChange

The leaders a company gained or lost in one month, at one seniority level.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | no | `GainedLeader` when leaders joined the company, `LostLeader` when they left it. |
| `seniorityLevel` | string | no | The leaders' seniority level, as the `leadershipChange.seniorityLevels` filter takes it. |
| `detectedMonth` | string | no | The month of the change, as its first day. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `count` | integer (int32) | no | How many leaders joined or left. |

### SearchCompanyHiringSurge

A job function whose headcount grew at a company over one month.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | string | no | The job function, as the `hiringSurge.functions` filter takes it. |
| `snapshotMonth` | string | no | The month of the headcount snapshot, as its first day. ISO 8601, such as `2021-03-01T00:00:00`, with or without an offset. |
| `currentHeadcount` | integer (int32) | no | The function's headcount at the snapshot. |
| `previousHeadcount` | integer (int32) | no | The function's headcount before it. |
| `netAdds` | integer (int32) | no | How many people the function gained. |
| `growthPercent` | number (double) | no | The growth as a percentage of the earlier headcount. Null when the earlier headcount was 0. |

### SearchCompanyWebTechnology

A web technology Kenso found for a company's domain.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `key` | string | no | The technology's key, as the `webTechAny`, `webTechAll` and `webTechExclude` filters take it. |
| `name` | string | no | The technology's display name. |
| `categories` | array of string | no | The display names of the technology's categories. |

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