API Reference · core

Enrich companies via API

Pass a domain, company name, or LinkedIn company URL and get back firmographics, technographics, funding history, employee count, revenue estimate, and headquarters location — sourced from 15+ providers for the most complete company profile available.

Endpoint

POST https://api.cleanlist.ai/v1/enrich/company

Request

POST https://api.cleanlist.ai/v1/enrich/company
Authorization: Bearer clnl_live_...
Content-Type: application/json

{
  "email": "jane@acme.com"
}

Response

{
  "id": "ev_k7r3wq1",
  "status": "completed",
  "company": {
    "name": "Acme Corp",
    "domain": "acme.com",
    "industry": "Computer Software",
    "sub_industry": "SaaS / Cloud Computing",
    "size": "201-500",
    "employee_count": 340,
    "revenue": "$50M-$100M",
    "funding_total": "$45M",
    "last_funding_round": "Series B",
    "last_funding_date": "2025-06-15",
    "founded_year": 2019,
    "hq_location": "San Francisco, CA, USA",
    "technologies": [
      "Salesforce",
      "HubSpot",
      "AWS",
      "Segment",
      "Snowflake"
    ],
    "linkedin_url": "https://linkedin.com/company/acmecorp",
    "description": "Enterprise workflow automation platform for operations teams."
  },
  "meta": {
    "credits_used": 1,
    "providers_queried": 15,
    "providers_matched": 11,
    "confidence": 0.98,
    "enriched_at": "2026-04-15T11:05:22Z"
  }
}

Field reference

Field	Type	Description
name	string	Registered company name, matched against corporate databases.
domain	string	Primary company website domain.
industry	string	Primary industry classification.
sub_industry	string	More specific industry vertical.
size	string	Employee count range bucket.
employee_count	integer	Estimated total employee count from LinkedIn and corporate filings.
revenue	string	Estimated annual revenue range.
funding_total	string	Total venture funding raised, if applicable.
last_funding_round	string	Most recent funding round type: Seed, Series A, B, C, etc.
last_funding_date	string	Date of most recent funding round (ISO 8601).
founded_year	integer	Year the company was founded.
hq_location	string	Headquarters city, state, country.
technologies	string[]	Detected tech stack: CRM, marketing automation, cloud, analytics, and more.
linkedin_url	string	LinkedIn company page URL.
description	string	Brief company description from corporate profiles.

Code samples

curl

curl -X POST https://api.cleanlist.ai/v1/enrich/company \
  -H "Authorization: Bearer $CLEANLIST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com"}'

Node.js

import Cleanlist from "cleanlist";

const client = new Cleanlist(process.env.CLEANLIST_API_KEY);

const result = await client.enrich.company({
  email: "jane@acme.com",
});
console.log(result.company.title);

Python

from cleanlist import Cleanlist

client = Cleanlist(api_key=os.environ["CLEANLIST_API_KEY"])

result = client.enrich.company(email="jane@acme.com")
print(result["company"]["title"])

Common use cases

ABM account research

Enrich your target account list with firmographics, tech stack, and funding data to prioritize accounts and personalize outreach without manual research.

Market segmentation

Enrich a list of domains to segment by industry, size, revenue, and technology — then build targeted campaigns for each segment.

Competitive intelligence

Monitor competitor customer domains to track their tech stack changes, funding events, and growth signals.

Lead-to-account matching

Match incoming leads to enriched company records for account-based routing. Attach firmographics to every lead automatically.

Pricing

Credit-based, no per-seat fees. This endpoint uses the standard enrichment rate:

Email only: 1 credit per enriched company.
Email + phone: 11 credits per enriched company.
Free tier: 30 credits/mo. See all pricing.

FAQ

What input does the company enrichment endpoint accept?

You can pass a domain name, company name, or LinkedIn company URL. Domain is the most reliable identifier with a 98%+ match rate. Company name matching works best when you also include a country or domain hint to disambiguate common names.

How accurate is the revenue estimate?

Revenue estimates are sourced from public filings, funding databases, employee count models, and third-party data providers. For public companies, accuracy is within 5%. For private companies, estimates are range-based (e.g., '$10M-$25M') and are accurate within one range bucket for approximately 80% of companies.

How many technologies can be detected per company?

Cleanlist detects technologies across 200+ categories including CRM, marketing automation, analytics, cloud infrastructure, development tools, and more. A typical mid-market SaaS company returns 15-40 detected technologies. Detection is based on website scanning, job posting analysis, and third-party technology databases.

Does company enrichment cost the same as contact enrichment?

Company enrichment costs 1 credit per lookup. This returns firmographics, technographics, and funding data. If you also need contact data for people at the company, use the contacts or buying-committees endpoint, which costs 11 credits per record with phone numbers.

Next steps

Full REST reference: /product/api.
Related glossary: data enrichment, waterfall enrichment.
Ready to ship? Start free with 30 credits.