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
- 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