REST API / Companies

Enrich a company

A company profile from its domain: industry, NAICS, headcount, revenue range, location, founded year, description and technologies, with a last-seen date and confidence on every field.

POST/v1/companies/enrichMCP: enrich_company

Records

1 when found

Meters

enrichment records + requests / 5 hrs, records / week

Not found

0 records · 1 request

Body parameters

domainstring

Domain or website URL, e.g. "northwind.io" or "https://www.northwind.io/pricing".

linkedin_urlstring

A linkedin.com/company/… URL, when you have no domain.

promptstring

Optional. The request in plain language, up to 1,000 characters. Stored with the call in your request log.

Send domain or linkedin_url. If you send both, domain is used.

Response

company with company_id, name, domain, linkedin_url, industry, naics, employees, employee_range, revenue_range, location, founded_year, description, technologies, freshness (refreshed_at, confirmed_at, stale_after_at, stale) and sources, which gives the last-seen date and confidence of every returned field. Then usage and request_id.

To find people at the company next, pass its domain to POST /v1/people/search as company_domain.

Errors

Status	type	Meaning
`400`	`invalid_request`	A value isn't valid. The message names the field in `param`.
`401`	`unauthorized`	Missing, invalid, expired or revoked key. See Authentication.
`402`	`free_records_exhausted`	Free plan: the 1,000 free enrichment records or the 1,000 free data calls are used up.
`403`	`forbidden`	The key is read only. Data tools need a key with data access.
`404`	`not_found`	No company found for that input. Nothing was counted.
`429`	`window_full`	A five-hour records or requests window is full. See Retry-After and `resets_at`.
`429`	`weekly_limit`	The seven-day records limit is reached. Resume after `resets_at`.

Previous
← enrich_personNext
verify_email →

Was this page useful? Tell us

cURLTypeScriptPython

curl https://api.leadsets.ai/v1/companies/enrich \
  -H "Authorization: Bearer $LEADSETS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 1f7b…" \
  -d '{
    "domain": "northwind.io"
  }'

import { Leadsets } from "@leadsetsai/sdk";

const ls = new Leadsets(process.env.LEADSETS_KEY);
const res = await ls.companies.enrich({
  domain: "northwind.io",
});

import os
from leadsets import Leadsets

ls = Leadsets(os.environ["LEADSETS_KEY"])
res = ls.companies.enrich(
    domain="northwind.io",
)

Response200 OK

{
  "company": {
    "company_id": "8c1f0b7a-52d4-4c3e-9e61-2a7d5f0c9b48",
    "name": "Northwind Analytics",
    "domain": "northwind.io",
    "linkedin_url": "https://www.linkedin.com/company/northwind-analytics",
    "industry": "SaaS",
    "naics": "518210",
    "employees": 120, "employee_range": "51-200",
    "revenue_range": "10M-50M",
    "location": { "country": "US", "region": "CA", "city": "San Francisco" },
    "founded_year": 2017,
    "description": "Product analytics for B2B teams.",
    "technologies": ["hubspot", "segment", "stripe"],
    "refreshed_at": "2026-11-01T00:00:00Z", "stale": false,
    "sources": { "employees": { "seen_at": "2026-11-01T00:00:00Z",
                                "confidence": 0.9 } }
  },
  "usage": { "enrich_records_counted": 1, "enrich_records_left_5h": 14999,
             "enrich_requests_left_5h": 74999, "enrich_records_left_week": 74999 },
  "request_id": "req_2c9e7d1a5b40"
}