API

Search for a name

Resource Uri:

http://globalnames.org/name_strings.xml (xml output)

http://globalnames.org/name_strings.json (json output)

http://globalnames.org/name_strings (html output)

Parameters:

search_term

name pattern you want to search for, usually you want to include ‘*’ (whildcard character) at the end of the search

Notes:

• some search terms need to be url-escaped
• searches with wildcards cannot be shorter than 3 characters

per_page (default is 30)

number of items per one page (numbers larger than 1000 will be decreased to 1000)

page (default is 1)

page number you want to see.

Search will return ‘next_page’ field if more data exist for the search

Examples

valid

http://globalnames.org/name_strings.xml?search_term=ani*
http://globalnames.org/name_strings.json?search_term=ani*
http://globalnames.org/name_strings.xml?search_term=ani%25
http://globalnames.org/name_strings.xml?search_term=ama*&per_page=3&page=21
http://globalnames.org/name_strings.xml?search_term=animalia&per_page=3&page=21

invalid

-  search string is too short:
http://globalnames.org/name_strings.xml?search_term=a*&per_page=3&page=21

Name Details

Resource Uri:

http://globalnames.org/name_strings/{id}.xml

http://globalnames.org/name_strings/{id}.json

http://globalnames.org/name_strings/{id}

Parameters:

all_records

returns all records from all repositories for the name string

Examples:

http://globalnames.org/name_strings/1.xml
http://globalnames.org/name_strings/1.json
http://globalnames.org/name_strings/1