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.
Start from the account
A CRM account, a target list or a lead's employer that carries the company's public page URL.
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.
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
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 field | Response field |
|---|---|
| Company name | company_name |
| Industry | industry |
| Employee count | employee_count |
| Size band | company_size |
| Headquarters | headquarters |
| Founded | founded_year |
| Website | website |
| Company type | company_type |
| Specialties | specialties[] |
| Office locations | locations[] |
| Funding | funding.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
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
Get your API key
1 minPOST a company page URL
1 minWrite firmographics back
Instant