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

# Company data

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

Company data is what Kenso knows about a company, looked up by its website domain: its brand (name, description and logo), the technologies seen on its website, and its funding. The data is the same for every workspace and costs no credits. Each answer that finds data, and each request for `branding`, counts one row toward the workspace's `searchBrowseRows` quota, the same quota Kenso Search lookups use. The `branding` kind (logo, colors and fonts read from the company's live website) is opt-in and costs credits.

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

- `GET /v1/company-data` - Get company data by domain (`company-data.get`): [/docs/api/company-data/get.md](/docs/api/company-data/get.md)

## Get company data by domain

`GET /v1/company-data` - operationId `company-data.get`

| Permission | Credits | Rate limit |
| --- | --- | --- |
| Search view | Varies with the request (`web_scrape`) | 200 requests a minute per API key |

Returns a company's brand, technologies and funding for a website domain, and on request its branding (logo,
colors and fonts). Use it to enrich an account or a contact's company before you write to them.

Kenso looks the domain up as its registrable domain, so `https://www.eu.acme.com/about` and `jane@acme.com`
both find `acme.com`. Brand and funding come from the Kenso Search company that owns the domain. Technologies
come from Kenso's archive of the company's website. A kind is absent from the answer when you did not ask for it
or Kenso has no data for it.

A request counts one row toward the workspace's `searchBrowseRows` quota when its answer has a found company
or technologies, or when `kinds` names `branding`. Any other request counts nothing. A request that names
`branding` counts its row even when it finds no branding or ends in 402.

`branding` is returned only when `kinds` names it, and only in a workspace where Kenso turned it on;
elsewhere it is an unknown kind. Kenso reads the logo, colors and fonts from the company's live home page. A
lookup that finds branding costs credits as one page read (the `web_scrape` line of the credit rate card),
or nothing when the workspace connected its own Firecrawl key, which then pays the read. A lookup that finds no
branding, or fails, costs nothing.
Kenso keeps each read for 30 days and shares it across workspaces, so a repeat lookup in that time costs nothing.

Errors:

- `400 validation_failed`: `domain` is missing or not a valid domain, `domain` is a free email
provider such as gmail.com, or `kinds` holds an unknown kind.
- `402 plan_limit_reached`: `kinds` names `branding` and the workspace has no credits for it, or
its own Firecrawl key failed. `error.refusal` says which.
- `429 quota_exceeded`: the workspace used its `searchBrowseRows` quota. Retry after the number of
seconds in the `Retry-After` header.
- `503 service_unavailable`: Kenso Search did not answer. Retry in a minute.

Requires Search view.

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

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `domain` | query | string | no | The company's website domain, a URL on it, or an email address at it, such as `acme.com`. |
| `kinds` | query | string | no | Comma-separated kinds to return: `brand`, `technologies`, `funding` and, where turned on, `branding`. Omitted returns brand, technologies and funding, never `branding`. |
| `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 `CompanyData`.

| Field | Type | Description |
| --- | --- | --- |
| `domain` | string | The registrable domain Kenso looked up, such as `acme.com` for `https://www.eu.acme.com/about`. |
| `isCompanyFound` | boolean | True when Kenso Search has a company that owns the domain, which is where brand and funding come from. Absent when you asked for neither brand nor funding, because Kenso did not look for the company. |
| `brand` | CompanyBrand | The company's name, description and logo. Absent when not asked for or when Kenso has none. |
| `technologies` | CompanyTechnologies | The technologies seen on the company's website. Absent when not asked for or when Kenso has no copy of the site. |
| `funding` | CompanyFunding | The company's funding. Absent when not asked for or when Kenso has none. |
| `branding` | CompanyBranding | The company's logo, colors and fonts, read from its live website. Returned only when `kinds` names `branding`, which costs credits. Absent when not asked for, when the website shows no branding Kenso can read, or when the read failed. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/company-data" \
  -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": {
    "domain": "acme.com",
    "isCompanyFound": true,
    "brand": {
      "name": "string",
      "description": "string",
      "logoUrl": "https://example.com",
      "source": "string",
      "fetchedAt": "2026-09-23T15:02:11Z"
    },
    "technologies": {
      "items": [
        {
          "name": "string",
          "categories": [
            "string"
          ],
          "lastSeenAt": "2026-09-23T15:02:11Z"
        }
      ],
      "source": "string",
      "capturedAt": "2026-09-23T15:02:11Z",
      "fetchedAt": "2026-09-23T15:02:11Z"
    },
    "funding": {
      "totalFunding": {
        "amount": 1,
        "currency": "usd"
      },
      "lastRound": {
        "type": "string",
        "amount": {
          "amount": 1,
          "currency": "usd"
        },
        "announcedDate": "2026-09-23"
      },
      "rounds": [
        {
          "type": "string",
          "amount": {
            "amount": 1,
            "currency": "usd"
          },
          "announcedDate": "2026-09-23"
        }
      ],
      "source": "string",
      "fetchedAt": "2026-09-23T15:02:11Z"
    },
    "branding": {
      "logoUrl": "https://example.com",
      "faviconUrl": "https://example.com",
      "socialImageUrl": "https://example.com",
      "colors": {
        "primary": "string",
        "secondary": "string",
        "accent": "string",
        "background": "string",
        "text": "string",
        "link": "string"
      },
      "fonts": [
        {
          "family": "string",
          "role": "heading"
        }
      ],
      "colorScheme": "light",
      "source": "string",
      "fetchedAt": "2026-09-23T15:02:11Z"
    }
  }
}
```

## Types

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

### CompanyBrand

A company's brand.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | The company's name. Null when Kenso has none. |
| `description` | string | no | A short description of the company. Null when Kenso has none. |
| `logoUrl` | string | no | The company's logo image, as an absolute http or https URL. Null when Kenso has none. |
| `source` | string | no | Where the data came from. Always `ken_search` today. |
| `fetchedAt` | string (date-time) | no | When Kenso read the data from its source, in UTC. |

### CompanyTechnologies

The technologies seen on a company's website.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array of CompanyTechnology | no | The technologies, most recently seen first, at most 200. Empty when Kenso has a copy of the site and found none. |
| `source` | string | no | Where the data came from. Always `ken_search` today: Kenso's archive of company websites. |
| `capturedAt` | string (date-time) | no | When the archived copy of the home page that Kenso read was captured, in UTC. Null when unknown. |
| `fetchedAt` | string (date-time) | no | When Kenso read the data from its source, in UTC. |

### CompanyFunding

A company's funding.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `totalFunding` | Money | no | The total funding the company raised, in US dollars. Null when Kenso does not know it. |
| `lastRound` | CompanyFundingRound | no | The company's most recent funding round. When Kenso knows of a round newer than every listed round but not its type or amount, only `announcedDate` is set. Null when Kenso knows no round. |
| `rounds` | array of CompanyFundingRound | no | The funding rounds Kenso knows, newest first, at most 20. |
| `source` | string | no | Where the data came from. Always `ken_search` today. |
| `fetchedAt` | string (date-time) | no | When Kenso read the data from its source, in UTC. |

### CompanyBranding

A company's visual branding, read from its live website.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `logoUrl` | string | no | The logo the website shows, as an absolute http or https URL. Null when Kenso found none. |
| `faviconUrl` | string | no | The website's icon, as an absolute http or https URL. Null when Kenso found none. |
| `socialImageUrl` | string | no | The image the website gives link previews (its Open Graph image), as an absolute http or https URL. Null when Kenso found none. |
| `colors` | CompanyBrandingColors | no | The website's colors. Null when Kenso could read none. |
| `fonts` | array of CompanyBrandingFont | no | The website's fonts with where it uses them, at most 10. Empty when Kenso could read none. |
| `colorScheme` | string | no | Whether the website is mostly light or dark: `light` or `dark`. Null when unknown. |
| `source` | string | no | Where the data came from. Always `website`: the company's live website. |
| `fetchedAt` | string (date-time) | no | When Kenso read the website, in UTC. Kenso keeps a read for 30 days, so a repeat lookup can return an older time. |

### CompanyTechnology

One technology seen on a company's website.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | The technology's name, such as HubSpot or Shopify. |
| `categories` | array of string | no | The technology's categories, such as `["Marketing automation"]`. Often one, sometimes none. |
| `lastSeenAt` | string (date-time) | no | When Kenso last saw the technology on the company's website, in UTC. Null when unknown. |

### Money

An amount of money.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `amount` | integer (int64) | no | The amount in the currency's smallest unit, such as cents for `usd`: 1250 is 12.50 dollars. |
| `currency` | string | no | The currency, as a lowercase three-letter ISO 4217 code such as `usd`. |

### CompanyFundingRound

One funding round.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | no | The round's type, such as Seed or Series B. Null when unknown. |
| `amount` | Money | no | The money raised in the round, in US dollars. Null when unknown. |
| `announcedDate` | string (date) | no | The date the round was announced, as YYYY-MM-DD. Null when unknown. |

### CompanyBrandingColors

A website's colors, each as `#RRGGBB` or null when Kenso could not read it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `primary` | string | no | The main brand color. |
| `secondary` | string | no | The second brand color. |
| `accent` | string | no | The color used for highlights and buttons. |
| `background` | string | no | The page background color. |
| `text` | string | no | The main text color. |
| `link` | string | no | The link color. |

### CompanyBrandingFont

A font a website uses.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `family` | string | no | The font family, such as Inter. |
| `role` | string | no | Where the website uses the font, such as `heading` or `body`. Null when unknown. |

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