Share via

NameAPI (Independent Publisher) (Preview)

  • Reference

NameAPI is a web API to handle people's names in your software.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Fördős András
Email [email protected]
Connector Metadata
Publisher Fördős András
Website https://www.nameapi.org/
Privacy policy https://www.nameapi.org/en/legal/privacy-policy/
Categories Data

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Detect disposable email address

Tells whether an email address is a disposable one.
Parse name

Parses a person's raw name, identifies the individual name parts.

Detect disposable email address

Operation ID:
DetectDea

Tells whether an email address is a disposable one.

Parameters

Name Key Required Type Description
Email address
 emailAddress True string

A syntactically valid email address, example: '[email protected]'

Returns

Name Path Type Description
Disposable
 disposable string

Indication, whether the email address is known to be disposable.

Parse name

Operation ID:
ParseName

Parses a person's raw name, identifies the individual name parts.

Parameters

Name Key Required Type Description
Person names
 Person names object
Gender
 gender string

The gender of the person.

Returns

Name Path Type Description
Matches
 matches array of object

Array of matches.
Parsed person
 matches.parsedPerson ParsedPersonRef

Information about the person: the computed gender, the addressing given name, the addressing surname.
Parser disputes
 matches.parserDisputes ParserDisputesRef

A list of consistency problems detected by the parser is within this object.
Likeliness
 matches.likeliness ParserLikelinessRef

A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.
Confidence
 matches.confidence ParserConfidenceRef

A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.
Parsed person
 bestMatch.parsedPerson ParsedPersonRef

Information about the person: the computed gender, the addressing given name, the addressing surname.
Parser disputes
 bestMatch.parserDisputes ParserDisputesRef

A list of consistency problems detected by the parser is within this object.
Likeliness
 bestMatch.likeliness ParserLikelinessRef

A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.
Confidence
 bestMatch.confidence ParserConfidenceRef

A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.

Definitions

ParsedPersonRef

Information about the person: the computed gender, the addressing given name, the addressing surname.

Name Path Type Description
Person type
 personType string

The type of person, it can be types of natural and legal people, and groups of them.
Person role
 personRole string

The role of the person. For example it can be the receiver, the owner or just a contact.
Mailing person roles
 mailingPersonRoles array of string

The roles of a person within a mailing address. It is of interest once not only a single, but multiple entities are mentioned.
Gender
 gender.gender string

The computed gender result.
Male proportion
 gender.maleProportion string

If the computed gender is neutral this may be specified (but does not have to be). A value 0-1, the remaining percentage is for the female gender.
Confidence
 gender.confidence float

A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.
Addressing given name
 addressingGivenName string

The given name that may be used when addressing the person.
Addressing surname
 addressingSurname string

The surname that may be used when addressing the person.
Terms
 outputPersonName.terms array of object

The list of extracted name related terms from the input person.
String
 outputPersonName.terms.string string

The string of the term.
Term type
 outputPersonName.terms.termType string

The type of the term.

ParserDisputesRef

A list of consistency problems detected by the parser is within this object.

Name Path Type Description
Items
 object

ParserLikelinessRef

A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.

A value in the range 0-1 that indicates how likely is it that this is the correct way of parsing. The higher the better.

Likeliness
float

ParserConfidenceRef

A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.

A value in the range 0-1 that indicates how sure the server is about the result. The higher the better.

Confidence
float