DATA ENRICHMENT API · PEOPLE
Enrich Every Lead With Data That Is Current Today
A data enrichment API for leads and contacts. Send a profile URL from any lead or CRM contact and get back the current job title, employer, work history, education and skills as JSON, read live when you ask for it. 1 credit, charged only on success.
POST/api/v1/person
{
"full_name": "Pratik Dani",
"job_title": "Founder",
"current_company_name": "Datamagnet",
"location": "Bengaluru, Karnataka, India",
"experience": [{ "job_still_working": true }]
}What is a data enrichment API for people?
A people enrichment API takes something you already know about a person and returns the attributes you are missing. Datamagnet's takes a public profile URL and, with use_cache set to never, reads the profile at the moment you call it, returning current job title, employer, work history, education and skills as structured JSON, for 1 credit charged only when the request succeeds.
- Input
- Public profile URL
- Cost
- 1 credit per profile
- Freshness
- Live on request (use_cache: never)
How lead enrichment works
Three steps from a thin record to a complete one. Run them on a form fill, a nightly CRM sync or a one-off list.
Start from the record
A CRM contact, an inbound lead or a spreadsheet row that carries a public profile URL. Most lead forms and CRMs already store one.
Find the profile if it is missing
Only a name and a company? Search by name, job title and company with the People Search endpoint, then take the matching profile URL.
Enrich and write back
POST the URL to /api/v1/person and map the fields you need onto the record. 1 credit, charged only when it succeeds.
One request per record
Call it from a webhook handler when a lead arrives, from a scheduled job that walks your CRM, or from a no-code tool. The response shape is the same every time, so the mapping is written once.
- Fixed JSON schema, documented field by field
- No charge for requests that fail
- One API key shared across your team, no seats
curl -X POST \
"https://api.datamagnet.co/api/v1/person" \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{"url": "https://linkedin.com/in/pratik-dani", "use_cache": "never"}'→ 200 OK · 1 credit
{ "message": { "full_name": "Pratik Dani", "job_title": "Founder", "current_company_name": "Datamagnet", "location": "Bengaluru, Karnataka, India", "experience": [...], "education": [...], "skills": [...] }}
Fields you can write back to the record
The ones teams map most often. The full profile carries 75+ fields; see the People API for the complete response.
| Record field | Response field |
|---|---|
| Job title | job_title |
| Company | current_company_name |
| Headline | profile_headline |
| Location | location, country_code |
| Still in the role? | experience[].job_still_working |
| Start date in role | experience[].job_started_on |
| Work history | experience[] |
| Education | education[] |
| Skills | skills[] |
| Open to work | is_open_to_work |
| Audience size | follower_count, connections |
Live enrichment vs a stored contact database
Different tools for different jobs. Many teams run both: a contact database for emails and dials, live enrichment for the fields that change.
| Question | Datamagnet (live) | Stored database |
|---|---|---|
| When the data was collected | At your request (use_cache: never) | At the last database refresh |
| A title changed this week | Returned as it is now | Returned as it was |
| You pay for a miss | No, only successful requests | Often, per lookup |
| Verified emails and direct dials | Only if published on the profile | Yes, the core product |
| People without a public profile | Not covered | Often covered |
Comparing vendors? See the best real-time data enrichment APIs and the vendor comparisons.
Keep records current
Create a job-change signal and the Signal API sends a webhook when someone moves, so you re-enrich only the records that changed.
Enrich the account too
Pass the employer to the Company Enrichment API for headcount, industry, headquarters and funding on the same record.
What it does not do
It is not an email or phone finder, and it covers people with a public profile only. Contact details come back only when the person published them.
Works from code, from AI agents through the MCP server, and from Clay, n8n and HubSpot.
Frequently asked questions
Enrich your first leads with 10 free credits
No credit card required. Get an API key and enrich ten records in the next five minutes.
- 1 credit per profile
- Charged only on success
- Live on request
Interactive Demo
~15 minutes
Get your API key
1 minPOST a profile URL
1 minWrite the fields back
Instant