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.

Step 1

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.

Step 2

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.

Step 3

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
enrich one lead
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 fieldResponse field
Job titlejob_title
Companycurrent_company_name
Headlineprofile_headline
Locationlocation, country_code
Still in the role?experience[].job_still_working
Start date in roleexperience[].job_started_on
Work historyexperience[]
Educationeducation[]
Skillsskills[]
Open to workis_open_to_work
Audience sizefollower_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.

QuestionDatamagnet (live)Stored database
When the data was collectedAt your request (use_cache: never)At the last database refresh
A title changed this weekReturned as it is nowReturned as it was
You pay for a missNo, only successful requestsOften, per lookup
Verified emails and direct dialsOnly if published on the profileYes, the core product
People without a public profileNot coveredOften 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

A people enrichment API takes something you already know about a person and returns the attributes you are missing, such as current job title, employer, work history, education and skills, as structured data your code can write into a CRM, a spreadsheet or a database.

A public profile URL. Most CRMs and lead forms already store one. If a record only has a name and a company, find the profile first with the People Search endpoint, which searches by name, job title and company for 10 credits a search, then enrich the match.

Not as a lookup. Datamagnet is not an email or phone finder: contact details come back only when the person has published them on their own profile. If verified work emails and direct dials are the goal, pair it with a contact database and use Datamagnet for the profile data that goes stale fastest.

Send use_cache: "never" and the API reads the public profile at the moment you call it, so a title changed this morning is what comes back. Without it the API may answer from a stored copy, which is faster; use "never" for anything that has to be current.

1 credit per enriched profile, charged only when the request succeeds. Plans start at $39/month for 1,000 credits, pay-as-you-go starts at $0.02 a credit, and every account gets 10 free credits with no card.

Either re-enrich on a schedule, or create a job-change signal for the people you care about and let the Signal API send a webhook when someone changes roles, so you only re-enrich the records that actually changed.

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

1

Get your API key

1 min
2

POST a profile URL

1 min
3

Write the fields back

Instant