The location API takes a name input and provides data on its raw incidence in countries/jurisdictions or regions.
The API works by taking a name input, e.g.
Name: Avetis
Type: forename
And it returns its raw incidence in countries/jurisdictions:
| Country | Incidence | Percent (of people in country with name) | Ratio | Rank (popularity in country) |
|---|---|---|---|---|
| Armenia | 2,080 | 0.071263408 | 1:1,403 | 280 |
| Russia | 448 | 0.000310446 | 1:322,117 | 4,342 |
| United States | 343 | 0.000094502 | 1:1,058,178 | 21,743 |
| et cetera. | ||||
The result is provided in JSON.
It can also return results of incidence at a regional level, e.g. Avetis (forename) in The United States:
| Country | Incidence | Percent (of people in country with name) | Ratio | Rank (popularity in country) |
|---|---|---|---|---|
| California | 305 | 0.000730530 | 1:136,887 | 6,682 |
| Nevada | 8 | 0.000142404 | 1:702,225 | 11,684 |
| Oregon | 7 | 0.000163206 | 1:612,721 | 13,041 |
| et cetera. | ||||
To interpret this literally this means that 305 people in California bear the forename Avetis, accounting for 0.000730530% of the state's population or 1 in 136,887 people and is the 6,682nd most popular name in the state (using the ordinal ranking method).