NameAPI (Independent Publisher) (Preview)
![](https://connectoricons-prod.azureedge.net/releases/v1.0.1676/1.0.1676.3617/nameapi/icon.png)
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 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
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
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