Developer tools

Enjoy some of Ethnicity Estimate's most popular endpoints. Download and use one of our Software Development Kit and Command Line Tool. Use them to analyze personal names and discover their origin, ethnicity and gender. Our SDK and CLI are powered by Namsor name origin, name ethnicity and name gender determination.

Use our name checking technology in your project

Our software development kit and command line tools enable you to easily integrate name analysis in your application's data flow.

Java SDK

Enpoints to process personal names to estimate origin, ethnicity and gender in all alphabets or languages.

Requirements

Java 1.7+
Maven/Gradle

Installation

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Maven users

Add this dependency to your project's POM:

<dependency>
  <groupId>com.namsor</groupId>
  <artifactId>namsor-sdk2</artifactId>
  <version>2.0.16</version>
  <scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile "com.namsor:namsor-sdk2:2.0.16"

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

target/namsor-sdk2-2.0.16.jar
target/lib/*.jar

Getting Started

Please follow the installation instruction and execute the following Java code:

import com.namsor.sdk2.invoke.*;
import com.namsor.sdk2.invoke.auth.*;
import com.namsor.sdk2.model.*;
import com.namsor.sdk2.api.AdminApi;

import java.io.File;
import java.util.*;

public class AdminApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: api_key
        ApiKeyAuth api_key = (ApiKeyAuth) defaultClient.getAuthentication("api_key");
        api_key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //api_key.setApiKeyPrefix("Token");

        AdminApi apiInstance = new AdminApi();
        String source = "source_example"; // String | 
        Boolean anonymized = true; // Boolean | 
        String token = "token_example"; // String | 
        try {
            apiInstance.anonymize(source, anonymized, token);
        } catch (ApiException e) {
            System.err.println("Exception when calling AdminApi#anonymize");
            e.printStackTrace();
        }
    }
}

Documentation For Authorization

api_key

Type: API key
API key parameter name: X-API-KEY
Location: HTTP header

Recommendation

It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Documentation for API Endpoints

All URIs are relative to https://v2.namsor.com/NamSorAPIv2

API documentation

Java SDK on GithHub

The Ethnicity Estimate Java software development kit is powered by Namsor's gender, ethnicity and origin name classification.

Namsor Java SDK on GithHub