Datagma
App · Contact Management · 7 actions
Enrich B2B leads and accounts with Datagma. Turn a LinkedIn URL, an email or a name and a company into a full contact record (job title, employer, location, verified work email and mobile number), look a company up by domain, LinkedIn page, name or French SIREN for its headcount, industry, funding and registry details, check whether a contact has changed jobs, find who a phone number belongs to, and read the credit balance before a batch.
Actions
| Action | What it does |
|---|---|
| Check the credit balance | Report how many Datagma credits are left on the connected key. |
| Check whether a contact changed jobs | Check whether someone still works at the company you have on file. |
| Enrich a company | Look one company up from its domain, LinkedIn page, name or French SIREN and get back its headcount, industry, headquarters, website and founding year, plus, on request, its funding rounds and revenue band, or its entry in the French company register. |
| Enrich a person | Look one person up from their LinkedIn profile URL or their work email address, and get back their job title, employer, location and, when you ask for them, their verified work email, their mobile number and their full LinkedIn history. |
| Enrich a person by name | Look one person up from their full name and the company they work at, and get back their job title, LinkedIn profile, location and, when you ask for them, their verified work email, their mobile number and their full LinkedIn history. |
| Find a work email | Find and verify someone's work email address from their name and their company. |
| Look up who owns a phone number | Find the person behind a phone number: their name and, when Datagma has it, their LinkedIn profile. |
Check the credit balance
Report how many Datagma credits are left on the connected key. This call is free (it is the one endpoint that does not spend a credit), so run it before a batch to check there is enough left, and branch on the number if there is not.
Inputs
None.
Outputs
account_emailtext- The email the Datagma account is registered to.
company_nametext- The company on the Datagma account.
countrytext- The account's country.
credits_remainingnumber- Credits left on the key.
objecttext- Always 'datagma_credit_balance'.
plantext- The plan the key is on.
Example output
{
"account_email": "you@example.com",
"credits_remaining": 160,
"object": "datagma_credit_balance",
"plan": "0"
}Check whether a contact changed jobs
Check whether someone still works at the company you have on file. Datagma looks up their current employer and answers with a plain 'changed jobs' true or false, plus where they are now. Use this to keep a CRM clean, or to spot a champion who has moved somewhere worth following them to. Coverage is strongest in France, Spain, Italy and Germany.
Inputs
- Full name
full_nametextRequired - The contact's full name, e.g. 'Jane Doe'.
- Company you have on file
company_nametextRequired - The employer you last knew them to have. Datagma compares this against the one on their profile now.
- Job title (optional)
job_titletext - The role you have on file. Only needed to tell two people apart when they share a name at that company.
Outputs
changed_jobstrue/false- True when they have left the company you gave. Null when Datagma could not tell.
company_match_scorenumber- 0 to 1, how well the two companies match. 1 means the same employer.
credits_remainingnumber- Credits left on the key afterwards, when Datagma reported it.
credits_usednumber- Credits this call spent. Datagma does not charge for a genuine no-match.
current_companytext- Where their profile says they work now.
experience_countnumber- How many past roles Datagma could read.
experienceslist- Their roles, most recent first.
foundtrue/false- False when Datagma could not find the person. Not an error.
known_companytext- The company you gave.
objecttext- Always 'datagma_job_change'.
personobject- Who Datagma matched.
searched_fortext- The name searched for.
statustext- Datagma's own verdict word, e.g. 'NO_NEW_COMPANY'.
Example output
{
"changed_jobs": false,
"company_match_score": 1,
"credits_remaining": 156,
"credits_used": 1,
"current_company": "Datagma",
"experience_count": 3,
"found": true,
"known_company": "Datagma",
"object": "datagma_job_change",
"person": {
"first_name": "Raphael",
"full_name": "Raphael Azot",
"job_title": "Co-Founder & CEO",
"last_name": "Azot",
"linkedin_url": "https://www.linkedin.com/in/raphaelazot"
},
"searched_for": "Raphael Azot",
"status": "NO_NEW_COMPANY"
}Enrich a company
Look one company up from its domain, LinkedIn page, name or French SIREN and get back its headcount, industry, headquarters, website and founding year, plus, on request, its funding rounds and revenue band, or its entry in the French company register. Use this to qualify inbound signups or to score an account list.
Inputs
- Company
companytextRequired - The company, given any way you have it: a domain (acme.com), a LinkedIn company URL, a company name, or a French SIREN number. A domain or a LinkedIn URL is an exact match; a bare name is a best guess, and the 'confidence' in the result says how good it was.
- Details to fetch
includetext - Which blocks of company data to ask for. Each is a separate lookup, and funding and the French registry are paid add-ons; on a plan without one, asking for it fails the whole step rather than returning the rest. Defaults to the profile on its own.One or more of:
profile(Profile - headcount, industry, headquarters, website, founded),funding(Funding and traffic - rounds, investors, revenue range, traffic rank),french_registry(French registry - SIREN, SIRET, NAF code (French companies)). Default:["profile"].
Outputs
companyobject- The company Datagma matched.
confidencenumber- 0 to 1, how sure Datagma is of the match. 1 for a domain or a LinkedIn URL.
credits_remainingnumber- Credits left on the key afterwards, when Datagma reported it.
credits_usednumber- Credits this call spent. Datagma does not charge for a genuine no-match.
foundtrue/false- False when Datagma matched no company. Not an error.
inputtext- What was searched for.
input_typetext- How Datagma read it: 'domain', 'linkedin_url', 'siren' or 'name'.
objecttext- Always 'datagma_company'.
Example output
{
"company": {
"company_size": "11-50 employees",
"company_type": "Privately Held",
"description": "B2B data enrichment: find emails, phone numbers and company data.",
"employee_count": 24,
"founded": "2020",
"headquarters": "Paris, Ile-de-France",
"headquarters_country": "France",
"industry": "Information Technology & Services",
"linkedin_url": "https://www.linkedin.com/company/datagma",
"name": "Datagma",
"specialties": [
"Data enrichment",
"Email finder",
"Phone finder"
],
"website": "https://datagma.com"
},
"confidence": 1,
"credits_remaining": 158,
"credits_used": 1,
"found": true,
"input": "datagma.com",
"input_type": "domain",
"object": "datagma_company"
}Enrich a person
Look one person up from their LinkedIn profile URL or their work email address, and get back their job title, employer, location and, when you ask for them, their verified work email, their mobile number and their full LinkedIn history. Use this to fill in a lead from a form submission or a CRM record. If all you have is a name, use 'Enrich a person by name'.
Inputs
- LinkedIn profile URL or work email
persontextRequired - The person, identified by either: their LinkedIn profile URL (the most accurate, and Sales Navigator lead links work too) or their work email address. If all you have is their name, use 'Enrich a person by name' instead.
- Full name (only with an email)
full_nametext - Their name, when you identified them by email above. Datagma can match the wrong person on a shared domain without it. Leave empty for a LinkedIn URL.
- Also look up
includetext - Extra details to fetch alongside the basics. Each is a separate lookup and a paid add-on: on a plan that does not carry one, asking for it fails the whole step rather than returning the rest, so tick one only if your plan includes it. Leave empty for the basics, which every plan includes: name, title, employer, location and LinkedIn URL.One or more of:
full_profile(Full LinkedIn profile - experience, education, about, skills),phone(Mobile phone number),whatsapp(Check whether that mobile number is on WhatsApp),company(Their employer's company profile).
Outputs
companyobject- The company Datagma matched.
company_confidencenumber- 0 to 1, how well the employer found matches the company you gave. A low value can mean they changed jobs.
confidencenumber- 0 to 1, how sure Datagma is this is the right person. 1 for a LinkedIn URL.
credits_remainingnumber- Credits left on the key afterwards, when Datagma reported it.
credits_usednumber- Credits this call spent. Datagma does not charge for a genuine no-match.
emailobject- The email address found on the person, when one was.
foundtrue/false- False when Datagma matched nobody. Not an error.
matched_ontext- Which identifier was used: 'linkedin_url', 'email' or 'name_and_company'.
objecttext- Always 'datagma_person'.
personobject- The person Datagma matched.
phoneobject- The best phone number found. Only when a phone lookup was requested.
Example output
{
"company_confidence": 1,
"confidence": 1,
"credits_remaining": 159,
"credits_used": 1,
"email": {
"address": "raphael@datagma.com",
"domain": "datagma.com",
"status": "valid",
"verified": true
},
"found": true,
"matched_on": "linkedin_url",
"object": "datagma_person",
"person": {
"city": "Paris",
"company_name": "Datagma",
"country": "France",
"education_count": 2,
"experience_count": 4,
"first_name": "Raphael",
"full_name": "Raphael Azot",
"job_title": "Co-Founder & CEO",
"last_name": "Azot",
"linkedin_url": "https://www.linkedin.com/in/raphaelazot",
"location": "Paris, Ile-de-France, France",
"role": "founder",
"seniority": "c_suite"
}
}Enrich a person by name
Look one person up from their full name and the company they work at, and get back their job title, LinkedIn profile, location and, when you ask for them, their verified work email, their mobile number and their full LinkedIn history. Datagma searches for somebody inside a company, so both the name and the company are needed. Use this to work through a list of names, or a CRM export with no email addresses.
Inputs
- Full name
full_nametextRequired - Their full name, e.g. 'Jane Doe'.
- Company they work at
companytextRequired - Their employer: a domain (acme.com), a LinkedIn company URL, or a company name. A domain or a LinkedIn URL is an exact match; a bare name is a best guess, and the 'confidence' in the result says how good it was.
- Also look up
includetext - Extra details to fetch alongside the basics. Each is a separate lookup and a paid add-on: on a plan that does not carry one, asking for it fails the whole step rather than returning the rest, so tick one only if your plan includes it. Leave empty for the basics, which every plan includes: name, title, employer, location and LinkedIn URL.One or more of:
full_profile(Full LinkedIn profile - experience, education, about, skills),phone(Mobile phone number),whatsapp(Check whether that mobile number is on WhatsApp),company(Their employer's company profile).
Outputs
companyobject- The company Datagma matched.
company_confidencenumber- 0 to 1, how well the employer found matches the company you gave. A low value can mean they changed jobs.
confidencenumber- 0 to 1, how sure Datagma is this is the right person. 1 for a LinkedIn URL.
credits_remainingnumber- Credits left on the key afterwards, when Datagma reported it.
credits_usednumber- Credits this call spent. Datagma does not charge for a genuine no-match.
emailobject- The email address found on the person, when one was.
foundtrue/false- False when Datagma matched nobody. Not an error.
matched_ontext- Which identifier was used: 'linkedin_url', 'email' or 'name_and_company'.
objecttext- Always 'datagma_person'.
personobject- The person Datagma matched.
phoneobject- The best phone number found. Only when a phone lookup was requested.
Example output
{
"company_confidence": 1,
"confidence": 0.94,
"credits_remaining": 158,
"credits_used": 1,
"email": {
"address": "raphael@datagma.com",
"domain": "datagma.com",
"status": "valid",
"verified": true
},
"found": true,
"matched_on": "name_and_company",
"object": "datagma_person",
"person": {
"city": "Paris",
"company_name": "Datagma",
"country": "France",
"education_count": 2,
"experience_count": 4,
"first_name": "Raphael",
"full_name": "Raphael Azot",
"job_title": "Co-Founder & CEO",
"last_name": "Azot",
"linkedin_url": "https://www.linkedin.com/in/raphaelazot",
"location": "Paris, Ile-de-France, France",
"role": "founder",
"seniority": "c_suite"
}
}Find a work email
Find and verify someone's work email address from their name and their company. Datagma checks the mailbox before answering, so a returned address is confirmed rather than guessed, except on a domain that accepts all mail, where it returns its best guess and flags it (and does not charge for it). Use this to complete a lead list before a campaign.
Inputs
- Full name
full_nametextRequired - The person's full name, e.g. 'Jane Doe'.
- Company
companytextRequired - Their employer, as a domain (acme.com) or a company name. A domain is the more reliable of the two.
- LinkedIn URL (optional)
linkedin_urltext - The person's or the company's LinkedIn URL. Datagma reports this raises the match rate by around 20% when you do not have the company's domain.
- Which country do they work in?
regiontext - Only needed for a company with separate domains per country (fr.ibm.com against jp.ibm.com). Leave on General otherwise.One of:
General(General - no particular country),Afghanistan,Albania,Algeria,Argentina,Armenia,Australia,Austria,Azerbaijan,Bahrain, and 92 more. Default:General. - What to return
resulttext - Return the full email address, or stop at the company's email domain. Both cost the same; the domain-only lookup is faster.One of:
3(Full verified email address),2(The company's email domain only (faster)). Default:3.
Outputs
catch_all_guesstrue/false- True when the domain accepts all mail so the address is Datagma's best guess. Not charged for.
companytext- The company searched at.
credits_remainingnumber- Credits left on the key afterwards, when Datagma reported it.
credits_usednumber- Credits this call spent. Datagma does not charge for a genuine no-match.
domaintext- The company's email domain.
emailtext- The address found.
foundtrue/false- False when Datagma found no address. Not an error.
mx_foundtrue/false- Whether the domain has mail servers.
objecttext- Always 'datagma_email'.
patternslist- Address patterns Datagma sees on that domain, e.g. 'first.last'.
returnedtext- What was asked for: 'email_address' or 'domain'.
searched_fortext- The name searched for.
smtp_checktrue/false- Whether the mailbox answered an SMTP check.
statustext- Datagma's own status word.
verifiedtrue/false- True only when Datagma confirmed the mailbox accepts mail.
Example output
{
"catch_all_guess": false,
"company": "datagma.com",
"credits_remaining": 157,
"credits_used": 1,
"domain": "datagma.com",
"email": "raphael@datagma.com",
"found": true,
"mx_found": true,
"object": "datagma_email",
"patterns": [
"first"
],
"returned": "email_address",
"searched_for": "Raphael Azot",
"smtp_check": true,
"status": "valid",
"verified": true
}Look up who owns a phone number
Find the person behind a phone number: their name and, when Datagma has it, their LinkedIn profile. Use this to put a name to a missed call or an inbound number before you call back.
Inputs
- Country
country_codetext - The number's country. Leave this empty if the number below is in full international form (+33612345678); a number that states its own country wins over this.One of:
+93(Afghanistan (+93)),+355(Albania (+355)),+213(Algeria (+213)),+54(Argentina (+54)),+374(Armenia (+374)),+61(Australia (+61)),+43(Austria (+43)),+994(Azerbaijan (+994)),+973(Bahrain (+973)),+880(Bangladesh (+880)), and 90 more. - Phone number
phone_numbertextRequired - The number, however you have it: with or without its country code, and with spaces, dots or dashes. The national dialling 0 that comes with a number written out domestically is dropped for you.
Outputs
credits_remainingnumber- Credits left on the key afterwards, when Datagma reported it.
credits_usednumber- Credits this call spent. Datagma does not charge for a genuine no-match.
foundtrue/false- False when Datagma matched nobody. Not an error.
objecttext- Always 'datagma_phone_owner'.
personobject- Who the number belongs to.
phone_numbertext- The number as it was sent, in international form.
Example output
{
"credits_remaining": 155,
"credits_used": 1,
"found": true,
"object": "datagma_phone_owner",
"person": {
"full_name": "Emmanuel Dupont",
"linkedin_url": "https://www.linkedin.com/in/emmanuel-dupont"
},
"phone_number": "+33612345678"
}