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

News

16.12.2024

Dictionary Update: Armenian Names

The Armenian language, part of the Indo-European family, stands out and forms its own branch....


18.11.2024

Dictionary Update: Ukrainian Names

A member of the East Slavic family, the Ukrainian language shares deep historical roots with...


04.11.2024

New Python Client Library Released

We have implemented a Python client library, now available on PyPI, providing easy access to...


22.10.2024

Software Version 10.6.0 Released

This update brings several improvements and new features designed to enhance the accuracy and...


11.10.2024

Discovering Czech Names

As part of the West Slavic group, the Czech language shares similarities with Slovak and Polish,...


Downloads

 

We provide software libraries to make your integration of the name api into your software as smooth as possible.

For non-techies: you can't download NameAPI. It's a hosted software to which your software connects by sending small requests. These libraries offered here make your programmer feel like the software was local.

 

 

Java and the JVM

 

This library is for Java, and for all programming languages running on the Java Virtual Machine including GroovyScala and Cold Fusion.

This library written in Java hides the REST details and offers a nice programming api. It's open source and managed on GitHub. It uses command4j (a general-purpose command framework) and anythingworks (a rest/soap utility library for building clients and services). They're both on GitHub, too.

You may still roll your own solution. We recommend using this library instead. Thanks to command4j, it offers many ready-made client-side interceptors such as failover, exception translation, logging, and timeouts.

Maven

Just include this in your pom.xml:

<dependency>
  <groupId>org.nameapi.client</groupId>
  <artifactId>nameapi-client</artifactId>
  <version>5.4.2</version>
</dependency>

Gradle

Just include this in your build.gradle:

implementation 'org.nameapi.client:nameapi-client:5.4.2'

Github

The project is on GitHub.

Source/Jar Download

Or download the release from here.

 

 

Python

 

We have implemented a Python client library, available on PyPI, providing easy access to NameAPI’s web services. This library simplifies the integration of NameAPI’s tools for processing personal names into Python applications.

Install the library from PyPI with this command:

pip install nameapi-client-python

GitHub

The project is on GitHub: NameAPI Python Client Library.

Sending JSON Objects

If you want to send JSON objects directly to NameAPI services, you can also refer to a blog post written by Julien Salinas, which demonstrates how to send requests using both Python and Go. This blog post provides a detailed comparison and step-by-step guide for using REST API to interact with NameAPI services:
REST API Fetching with Go and Python by Julien Salinas

Update the endpoint to the current one: https://api.nameapi.org/rest/v5.3

 

 

PHP

 

This library written in PHP hides the REST details and offers a nice, well documented programming api. It's open source and managed on GitHub.

If you use Composer (recommended) then add this to your composer.json as a dependency:

"require": {
"optimaize/nameapi-client-php": "dev-master",
}

 

 

Other Programming Languages

 

For the languages not listed above, there is currently no client library available. If you're interested in building one, please go ahead, we'd be happy to help.

You can call the REST web services directly using the standard HTTP protocol, and toolkits or frameworks for your programming language may simplify the task.

The SOAP/WSDL APIs are still present, though not actively developed anymore.

To use NameAPI with REST from Go or Python, see this blog post by Julien Salinas.
Update the endpoint to the current one: https://api.nameapi.org/rest/v5.3