Give a name and get back a list of nick names





Installs: 108 376

Dependents: 2

Suggesters: 0

Security: 0

Stars: 5

Watchers: 2

Forks: 126

v1.0.2 2017-11-09 18:48 UTC

This package is auto-updated.

Last update: 2022-08-06 04:48:10 UTC


A PHP class and data file that provides an API for looking up nicknames.


use Yooper\Nicknames;
$nicknames = new Nicknames();
// the passed in values are automatically normalized to lowercase
$names = $nicknames->query('Joe');
// nicknames also supports fuzzy matching

Original Credit


A CSV file that containing US given names (first name) and their associated nicknames or diminutive names.

This lookup file was initially created by mining this genealogy page. Because the lookup is based off of a dataset used for genealogy purposes there are some old names that aren't used commonly these days, but there are recent ones as well. Examples are "gregory", "greg", or "geoffrey", "geoff". There was also a significant effort to make it machine readable, i.e. separate it with commas, remove human conventions, like "rickie(y)" would need to be made into two different names "rickie", and "ricky".

There PHP class for your convenience.

This is a relatively large list with about 1600 names. Any help from people to clean this list up and add to it is greatly appreciated. Think of it as a wiki. Just request to join the project and you'll be added.

This project was created by Old Dominion University - Web Science and Digital Libraries Research Group. More information about the creation of this lookup can be found here.