Extract Structured Name Data with the Name Deducer API

Name Deducer API

What is the Name Deducer API?

The Name Deducer method takes a username or email address provided as a string and attempts to deduce a structured name.

How does it work?

Just like our Name Parser API, the Name Deducer method uses US population data to determine which parts of a username or email adress contain name data. We extract this name information into a structured name format, returning a JSON or XML response containing givenName, familyName, middleNames, region, and a value representing the likelihood that the name data is correct.

Why would you use it?

This method is ideal for parsing structured name data from email addresses and usernames. Business email addresses often contain name data due to the use of standard account naming conventions in corporate email address formats.

Example Query

https://api.fullcontact.com/v2/name/deducer.json?email=bartdlorang@fullcontact.com&apiKey=xxxx

Parameters

email

The email parameter allows you to pass an email address.

username

The username parameter allows you to pass a username.

Example Response

JSON

 

XML

{
  "status": 200,
  "likelihood": 0.665,
  "nameDetails":  {
    "givenName": "Bart",
    "familyName": "Lorang",
    "middleNames":  [
      "D."
    ],
    "fullName": "Bart D. Lorang"
  },
  "region": "USA"
}

How Much Does It Cost?

The Name Deducer API is completely free to use, just sign up for a FullContact API key. Try it out and let us know what you think.

Reference the Name Deducer Docs for more information.

Like this post? Share it:

Recent Posts