> 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: Look up a company by LinkedIn URL

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

## Look up a company by LinkedIn URL

`GET /v1/search/companies/lookup` - operationId `search.lookup-company`

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

Get one company's full profile from its LinkedIn page URL, when you do not have its Search id.

Errors:

- `400 validation_failed`: `linkedInUrl` is missing.
- `404 not_found`: Search holds no company with this URL.
- `429 quota_exceeded`: the daily quota is used up.

Requires Search view.

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

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `linkedInUrl` | query | string | no | The page URL, such as `https://www.linkedin.com/company/acme`. |
| `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 `SearchCompany`.

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

### Request

```bash
curl -X GET "https://api.ken.so/v1/search/companies/lookup" \
  -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": {
    "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": [
      {
        "country": "string",
        "city": "string",
        "state": "string",
        "isHeadquarters": true
      }
    ],
    "specialties": [
      "string"
    ],
    "lastFundingRoundType": "string",
    "lastFundingAmount": 1,
    "lastFundingRoundAnnouncedDate": "2021-03-01T00:00:00",
    "raisedFundingRecently": true,
    "totalFunding": 1,
    "fundingTotalUsd": 1,
    "lastFundedAt": "string",
    "totalRoundsCount": 1,
    "lastRoundInvestorsCount": 1,
    "fundingRounds": [
      {
        "roundType": "string",
        "moneyRaised": 1,
        "announcedDate": "2021-03-01T00:00:00"
      }
    ],
    "similarCompanies": [
      1
    ],
    "leadershipChanges": [
      {
        "type": "string",
        "seniorityLevel": "string",
        "detectedMonth": "2021-03-01T00:00:00",
        "count": 1
      }
    ],
    "hiringSurges": [
      {
        "function": "string",
        "snapshotMonth": "2021-03-01T00:00:00",
        "currentHeadcount": 1,
        "previousHeadcount": 1,
        "netAdds": 1,
        "growthPercent": 0.5
      }
    ],
    "headcountGrew": true,
    "employeesCountPrevious": 1,
    "headcountGrowthAbs": 1,
    "headcountGrowthPct": 0.5,
    "headcountGrowthDetectedAt": "2021-03-01T00:00:00",
    "headcountGrowthMonth": "string",
    "webTechnologies": [
      {
        "key": "string",
        "name": "string",
        "categories": [
          "string"
        ]
      }
    ],
    "relevanceScore": 0.5,
    "lookalike": {
      "score": 1,
      "grade": 1
    }
  }
}
```

## Types

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

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

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