Namsor

Developer tools, integrate our name checking technology in your application

Download and use one of our SDK and CLI to benefit from some of Namsor's most popular features. Analyze personal names and discover their gender, their cultural origin or ethnicity or their diaspora.

Namsor's SDK software development kits and CLI command line tools

Our software development kits and command line tools are available in Java, Python, JavaScript and Golang. 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

  1. Java 1.7+
  2. 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

Extra notes

Namsor Java SDK on GithHub