Company data
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.
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | 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 date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy. |
X-Ken-Workspace-Id | header | integer (int64) | optional | 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. |
Get company data by domain
/v1/company-datacompany-data.get- Permission
- Search view
- Credits
- Varies with the request (
web_scrape) - Rate limit
- 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 [email protected] 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:domainis missing or not a valid domain,domainis a free email provider such as gmail.com, orkindsholds an unknown kind.402 plan_limit_reached:kindsnamesbrandingand the workspace has no credits for it, or its own Firecrawl key failed.error.refusalsays which.429 quota_exceeded: the workspace used itssearchBrowseRowsquota. Retry after the number of seconds in theRetry-Afterheader.503 service_unavailable: Kenso Search did not answer. Retry in a minute.
Requires Search view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
domain | query | string | optional | The company's website domain, a URL on it, or an email address at it, such as acme.com. |
kinds | query | string | optional | Comma-separated kinds to return: brand, technologies, funding and, where turned on, branding. Omitted returns brand, technologies and funding, never branding. |
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"Response 200
data is a CompanyData.
Show the 6 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
More in Contacts and companies:ContactsContact importsContact exportsTagsBlocklistBlocklist rulesContact fieldsCompaniesContact behaviorAll resources