COMPANY ENRICHMENT

Company Enrichment API: Firmographics Read Today

Company enrichment for CRM accounts and target lists. Send a company page URL from any account and get back industry, headcount, headquarters, founding year, website and funding as JSON, read live when you ask for it. 1 credit, charged only on success.

POST/api/v1/company

{
  "company_name": "Datamagnet",
  "industry": "Software Development",
  "employee_count": 11,
  "headquarters": "Bengaluru, Karnataka",
  "founded_year": 2023
}

What is a company enrichment API?

A company enrichment API takes an identifier for a business and returns the firmographics your account records are missing. Datamagnet's takes a company page URL and, with use_cache set to never, reads it at the moment you call it, returning industry, headcount, headquarters, founding year, website, specialties and funding as structured JSON, for 1 credit charged only when the request succeeds.

Input
Company page URL
Cost
1 credit per company
Freshness
Live on request (use_cache: never)

How account enrichment works

Three steps from a company name to a complete account. Run them when an account is created, on a nightly sync or across a target list.

Step 1

Start from the account

A CRM account, a target list or a lead's employer that carries the company's public page URL.

Step 2

Find the page if it is missing

Only a company name? Search for it with the Company Search endpoint and take the matching page URL.

Step 3

Enrich and write back

POST the URL to /api/v1/company and map firmographics onto the account. 1 credit, charged only when it succeeds.

One request per account

The response shape is fixed and documented, so the field mapping is written once and works for every account you enrich after it.

  • Firmographics and funding in one response
  • No charge for requests that fail
  • Credits shared across your team, no seats
enrich one account
curl -X POST \
  "https://api.datamagnet.co/api/v1/company" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://linkedin.com/company/datamagnet", "use_cache": "never"}'

→ 200 OK · 1 credit

{  "message": {    "company_name": "Datamagnet",    "industry": "Software Development",    "employee_count": 11,    "company_size": "11-50 employees",    "headquarters": "Bengaluru, Karnataka",    "website": "...",    "funding": {...}  }}

Fields you can write back to the account

The ones teams map most often. The firmographic data API reference lists the full response.

Account fieldResponse field
Company namecompany_name
Industryindustry
Employee countemployee_count
Size bandcompany_size
Headquartersheadquarters
Foundedfounded_year
Websitewebsite
Company typecompany_type
Specialtiesspecialties[]
Office locationslocations[]
Fundingfunding.total_rounds, funding.last_round, funding.investors

Go past the basic profile

Headcount and hiring trends

Add company_insights to the same request for headcount over time and hiring by function, the inputs for growth-based account scoring. +10 credits, charged only on success.

Funding from a domain

The funding-rounds endpoint takes a bare website domain and returns every round with amount, type and announcement date. 5 credits.

People at the account

Enrich the contacts on the account with the People Enrichment API, so the person and the company on a record come from the same read. People Enrichment API

What it does not do

There is no lookup from a domain to the full profile: send the company page URL, or find it by name first. It does not return technographics or revenue estimates. Need whole datasets rather than per-account calls? See company datasets.

Comparing vendors? See company enrichment APIs compared. Works from code, through the MCP server, and from Clay, n8n and HubSpot.

Frequently asked questions

A company enrichment API takes an identifier for a business and returns the firmographics your account records are missing, such as industry, headcount, headquarters, founding year, website and funding, as structured data you can write into a CRM or a database.

The company's public page URL for the full profile. If an account only has a name, find its page with the Company Search endpoint for 10 credits a search. Funding history is different: the funding-rounds endpoint accepts a plain website domain.

For funding rounds, yes: send the domain and get every round with amount, type and date for 5 credits. The full firmographic profile needs the company page URL, which Company Search can find from the company name.

Send use_cache: "never" and the company page is read at the moment you call the API, so headcount, headquarters and description are current as of that request. By default the API may answer from a stored copy up to 30 days old, which is faster.

1 credit per company profile, charged only when the request succeeds. The company_insights flag (headcount trends and hiring by function) adds 10 credits, and funding rounds by domain cost 5. Plans start at $39/month for 1,000 credits, with 10 free credits on signup.

Enrich your first accounts with 10 free credits

No credit card required. Get an API key and enrich ten accounts in the next five minutes.

  • 1 credit per company
  • Charged only on success
  • Live on request

Interactive Demo

~15 minutes

1

Get your API key

1 min
2

POST a company page URL

1 min
3

Write firmographics back

Instant