API Documentation

Behindthename.com's API is currently limited to three functions. Requests are made via HTTPS with parameters passed in the query string. Results are returned in XML format.

In all cases an API access key must be used. Visit the API gateway to get your API key.

Look up

This will return information about a given name.

URL: https://www.behindthename.com/api/lookup.php


keyY(none)your API access key
nameY(none)the name to look up
exactNnowhether the name supplied is exact (meaning there are no missing diacritics)

Return value: name details in XML format

Example: https://www.behindthename.com/api/lookup.php?name=mary&key=#key#

Random Name

This will return a random name.

URL: https://www.behindthename.com/api/random.php


keyY(none)your API access key
genderN(none)gender to restrict names to (eg. f for feminine names)
usageN(none)usage to restrict names to (eg. eng for English-language names)
numberN2number of given names to return (max 6)
randomsurnameNnopass yes to generate a random surname as well

Return value: list of names in XML format

Example: https://www.behindthename.com/api/random.php?usage=ita&gender=f&key=#key#

Related Names

This function is not currently available.