Description: Retrieves data on a names raw incidence in countries/jurisdictions and regions.
API URL:
| Parameter | |
| key | your API key (string, 32) |
| name | forename or surname (string) |
| type | (forename|surname) (string) |
| Parameter | |
| gender | return gender distribution for forenames (int, 0 = off, 1 = on, defaults to off) N.B. an extra credit is expended when gender results are returned |
| jurisdiction | iso jurisdiction code to get regional statistics from (string); see jurisdictions appendix for codes |
| level | administrative division level within jurisdiction to display, e.g. for The United States: 1 = states, 2 = counties and independent cities (int, 1-4, defaults to 1) |
| sanitize | whether to sanitize name input (int, 0 = off, 1 = on, defaults to off); documentation |
| limit | number of jurisdictions to return (int, 1-250, defaults to 250) |
| id | an id to keep track of your requests (mixed) |
Example request to get data for the forename David:
{
"jurisdictions":[
{
"incidence":"4622814",
"percent":"1.273659943",
"ratio":"79",
"rank":"4",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"1169151",
"percent":"2.099289720",
"ratio":"48",
"rank":"1",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"465176",
"percent":"0.374721410",
"ratio":"267",
"rank":"41",
"jurisdiction":"Mexico",
"iso":"mx"
},
{
"incidence":"425710",
"percent":"0.640263302",
"ratio":"156",
"rank":"38",
"jurisdiction":"France",
"iso":"fr"
},
{
"incidence":"415643",
"percent":"0.233567422",
"ratio":"428",
"rank":"52",
"jurisdiction":"Nigeria",
"iso":"ng"
},
{
"incidence":"400016",
"percent":"0.859695319",
"ratio":"116",
"rank":"10",
"jurisdiction":"Spain",
"iso":"es"
},
{
"incidence":"387692",
"percent":"1.160332325",
"ratio":"86",
"rank":"2",
"jurisdiction":"Canada",
"iso":"ca"
},
{
"incidence":"376947",
"percent":"0.918918873",
"ratio":"109",
"rank":"10",
"jurisdiction":"Uganda",
"iso":"ug"
},
{
"incidence":"344185",
"percent":"0.743257645",
"ratio":"135",
"rank":"8",
"jurisdiction":"Kenya",
"iso":"ke"
},
{
"incidence":"273908",
"percent":"0.371022693",
"ratio":"270",
"rank":"26",
"jurisdiction":"DR Congo",
"iso":"cd"
},
{
"incidence":"234961",
"percent":"1.650692570",
"ratio":"61",
"rank":"1",
"jurisdiction":"Australia",
"iso":"au"
},
{
"incidence":"209733",
"percent":"0.384600573",
"ratio":"260",
"rank":"4",
"jurisdiction":"South Africa",
"iso":"za"
},
{
"incidence":"154941",
"percent":"0.574014983",
"ratio":"174",
"rank":"15",
"jurisdiction":"Ghana",
"iso":"gh"
},
{
"incidence":"137303",
"percent":"0.066988358",
"ratio":"1493",
"rank":"242",
"jurisdiction":"Brazil",
"iso":"br"
},
{
"incidence":"135108",
"percent":"0.255583957",
"ratio":"391",
"rank":"53",
"jurisdiction":"Tanzania",
"iso":"tz"
},
{
"incidence":"125869",
"percent":"2.351975885",
"ratio":"43",
"rank":"3",
"jurisdiction":"Scotland",
"iso":"gb-sct"
},
{
"incidence":"105678",
"percent":"0.991704639",
"ratio":"101",
"rank":"26",
"jurisdiction":"Czech Republic",
"iso":"cz"
},
{
"incidence":"102856",
"percent":"0.323501780",
"ratio":"309",
"rank":"32",
"jurisdiction":"Peru",
"iso":"pe"
},
{
"incidence":"93980",
"percent":"0.036431485",
"ratio":"2745",
"rank":"298",
"jurisdiction":"Indonesia",
"iso":"id"
},
{
"incidence":"91736",
"percent":"1.091715087",
"ratio":"92",
"rank":"2",
"jurisdiction":"Israel",
"iso":"il"
},
{
"incidence":"89984",
"percent":"0.330298670",
"ratio":"303",
"rank":"47",
"jurisdiction":"Mozambique",
"iso":"mz"
},
{
"incidence":"86329",
"percent":"2.789798391",
"ratio":"36",
"rank":"1",
"jurisdiction":"Wales",
"iso":"gb-wls"
},
{
"incidence":"82978",
"percent":"0.718355579",
"ratio":"139",
"rank":"20",
"jurisdiction":"South Sudan",
"iso":"ss"
},
{
"incidence":"81939",
"percent":"0.382462182",
"ratio":"261",
"rank":"21",
"jurisdiction":"Cameroon",
"iso":"cm"
},
{
"incidence":"76800",
"percent":"0.203136244",
"ratio":"492",
"rank":"89",
"jurisdiction":"Sudan",
"iso":"sd"
},
{
"incidence":"74134",
"percent":"0.155158103",
"ratio":"645",
"rank":"108",
"jurisdiction":"Colombia",
"iso":"co"
},
{
"incidence":"70866",
"percent":"0.262791428",
"ratio":"381",
"rank":"65",
"jurisdiction":"Angola",
"iso":"ao"
},
{
"incidence":"69906",
"percent":"0.231418537",
"ratio":"432",
"rank":"47",
"jurisdiction":"Venezuela",
"iso":"ve"
},
{
"incidence":"68791",
"percent":"0.432833536",
"ratio":"231",
"rank":"32",
"jurisdiction":"Zambia",
"iso":"zm"
},
{
"incidence":"68134",
"percent":"0.047214102",
"ratio":"2118",
"rank":"229",
"jurisdiction":"Russia",
"iso":"ru"
},
{
"incidence":"62774",
"percent":"1.383943443",
"ratio":"72",
"rank":"2",
"jurisdiction":"New Zealand",
"iso":"nz"
},
{
"incidence":"60869",
"percent":"0.142306271",
"ratio":"703",
"rank":"162",
"jurisdiction":"Argentina",
"iso":"ar"
},
{
"incidence":"60570",
"percent":"0.344006685",
"ratio":"291",
"rank":"59",
"jurisdiction":"Chile",
"iso":"cl"
},
{
"incidence":"60450",
"percent":"0.531704918",
"ratio":"188",
"rank":"20",
"jurisdiction":"Rwanda",
"iso":"rw"
},
{
"incidence":"60324",
"percent":"0.391118795",
"ratio":"256",
"rank":"10",
"jurisdiction":"Zimbabwe",
"iso":"zw"
},
{
"incidence":"57841",
"percent":"0.054539710",
"ratio":"1834",
"rank":"380",
"jurisdiction":"Philippines",
"iso":"ph"
},
{
"incidence":"57058",
"percent":"0.804919861",
"ratio":"124",
"rank":"22",
"jurisdiction":"Sierra Leone",
"iso":"sl"
},
{
"incidence":"56020",
"percent":"0.057237135",
"ratio":"1747",
"rank":"310",
"jurisdiction":"Germany",
"iso":"de"
},
{
"incidence":"55568",
"percent":"1.196998285",
"ratio":"84",
"rank":"8",
"jurisdiction":"Ireland",
"iso":"ie"
},
{
"incidence":"49484",
"percent":"0.466758810",
"ratio":"214",
"rank":"27",
"jurisdiction":"Bolivia",
"iso":"bo"
},
{
"incidence":"48588",
"percent":"0.274010148",
"ratio":"365",
"rank":"73",
"jurisdiction":"Ecuador",
"iso":"ec"
},
{
"incidence":"45721",
"percent":"0.150248238",
"ratio":"666",
"rank":"72",
"jurisdiction":"Malaysia",
"iso":"my"
},
{
"incidence":"42910",
"percent":"0.266375448",
"ratio":"375",
"rank":"67",
"jurisdiction":"Guatemala",
"iso":"gt"
},
{
"incidence":"42894",
"percent":"0.003530722",
"ratio":"28323",
"rank":"3960",
"jurisdiction":"India",
"iso":"in"
},
{
"incidence":"42671",
"percent":"0.523006283",
"ratio":"191",
"rank":"6",
"jurisdiction":"Papua New Guinea",
"iso":"pg"
},
{
"incidence":"41679",
"percent":"0.045352576",
"ratio":"2205",
"rank":"305",
"jurisdiction":"Egypt",
"iso":"eg"
},
{
"incidence":"39170",
"percent":"0.340023707",
"ratio":"294",
"rank":"45",
"jurisdiction":"Belgium",
"iso":"be"
},
{
"incidence":"38830",
"percent":"0.372992285",
"ratio":"268",
"rank":"61",
"jurisdiction":"Portugal",
"iso":"pt"
},
{
"incidence":"38381",
"percent":"0.226367666",
"ratio":"442",
"rank":"79",
"jurisdiction":"Netherlands",
"iso":"nl"
},
{
"incidence":"37011",
"percent":"0.156631385",
"ratio":"638",
"rank":"124",
"jurisdiction":"Madagascar",
"iso":"mg"
},
{
"incidence":"33033",
"percent":"0.242959557",
"ratio":"412",
"rank":"69",
"jurisdiction":"Chad",
"iso":"td"
},
{
"incidence":"32253",
"percent":"0.300124617",
"ratio":"333",
"rank":"34",
"jurisdiction":"Haiti",
"iso":"ht"
},
{
"incidence":"32099",
"percent":"1.741725056",
"ratio":"57",
"rank":"7",
"jurisdiction":"Northern Ireland",
"iso":"gb-nir"
},
{
"incidence":"31155",
"percent":"0.704569195",
"ratio":"142",
"rank":"20",
"jurisdiction":"Liberia",
"iso":"lr"
},
{
"incidence":"30470",
"percent":"0.307639868",
"ratio":"325",
"rank":"68",
"jurisdiction":"Burundi",
"iso":"bi"
},
{
"incidence":"27691",
"percent":"0.280905060",
"ratio":"356",
"rank":"59",
"jurisdiction":"Sweden",
"iso":"se"
},
{
"incidence":"27646",
"percent":"0.161573690",
"ratio":"619",
"rank":"135",
"jurisdiction":"Malawi",
"iso":"mw"
},
{
"incidence":"26383",
"percent":"0.416001070",
"ratio":"240",
"rank":"36",
"jurisdiction":"El Salvador",
"iso":"sv"
},
{
"incidence":"26017",
"percent":"0.226088179",
"ratio":"442",
"rank":"117",
"jurisdiction":"Cuba",
"iso":"cu"
},
{
"incidence":"25283",
"percent":"0.126093858",
"ratio":"793",
"rank":"131",
"jurisdiction":"Romania",
"iso":"ro"
},
{
"incidence":"23262",
"percent":"0.223062080",
"ratio":"448",
"rank":"52",
"jurisdiction":"Dominican Republic",
"iso":"do"
},
{
"incidence":"23161",
"percent":"0.512934652",
"ratio":"195",
"rank":"34",
"jurisdiction":"Central African Republic",
"iso":"cf"
},
{
"incidence":"22644",
"percent":"0.463521527",
"ratio":"216",
"rank":"55",
"jurisdiction":"Congo",
"iso":"cg"
},
{
"incidence":"20601",
"percent":"0.250654255",
"ratio":"399",
"rank":"83",
"jurisdiction":"Switzerland",
"iso":"ch"
},
{
"incidence":"19207",
"percent":"0.217828998",
"ratio":"459",
"rank":"69",
"jurisdiction":"Honduras",
"iso":"hn"
},
{
"incidence":"18911",
"percent":"0.655981430",
"ratio":"152",
"rank":"3",
"jurisdiction":"Jamaica",
"iso":"jm"
},
{
"incidence":"18063",
"percent":"0.751281458",
"ratio":"133",
"rank":"11",
"jurisdiction":"Namibia",
"iso":"na"
},
{
"incidence":"17956",
"percent":"1.469111914",
"ratio":"68",
"rank":"11",
"jurisdiction":"East Timor",
"iso":"tl"
},
{
"incidence":"17675",
"percent":"1.020653287",
"ratio":"98",
"rank":"37",
"jurisdiction":"Guinea-Bissau",
"iso":"gw"
},
{
"incidence":"17576",
"percent":"0.018015639",
"ratio":"5551",
"rank":"918",
"jurisdiction":"Ethiopia",
"iso":"et"
},
{
"incidence":"17320",
"percent":"0.045546159",
"ratio":"2196",
"rank":"220",
"jurisdiction":"Poland",
"iso":"pl"
},
{
"incidence":"17267",
"percent":"0.238540668",
"ratio":"419",
"rank":"42",
"jurisdiction":"Togo",
"iso":"tg"
},
{
"incidence":"17214",
"percent":"0.361035817",
"ratio":"277",
"rank":"34",
"jurisdiction":"Costa Rica",
"iso":"cr"
},
{
"incidence":"16791",
"percent":"0.353056724",
"ratio":"283",
"rank":"116",
"jurisdiction":"Eritrea",
"iso":"er"
},
{
"incidence":"16607",
"percent":"0.140521492",
"ratio":"712",
"rank":"125",
"jurisdiction":"Guinea",
"iso":"gn"
},
{
"incidence":"16047",
"percent":"0.026241987",
"ratio":"3811",
"rank":"403",
"jurisdiction":"Italy",
"iso":"it"
},
{
"incidence":"14607",
"percent":"0.137914625",
"ratio":"725",
"rank":"140",
"jurisdiction":"Benin",
"iso":"bj"
},
{
"incidence":"14527",
"percent":"0.009110138",
"ratio":"10977",
"rank":"1423",
"jurisdiction":"Bangladesh",
"iso":"bd"
},
{
"incidence":"14147",
"percent":"0.235052711",
"ratio":"425",
"rank":"59",
"jurisdiction":"Nicaragua",
"iso":"ni"
},
{
"incidence":"14032",
"percent":"0.001023686",
"ratio":"97686",
"rank":"11178",
"jurisdiction":"China",
"iso":"cn"
},
{
"incidence":"12911",
"percent":"0.062075124",
"ratio":"1611",
"rank":"299",
"jurisdiction":"Sri Lanka",
"iso":"lk"
},
{
"incidence":"12476",
"percent":"0.319347421",
"ratio":"313",
"rank":"27",
"jurisdiction":"Panama",
"iso":"pa"
},
{
"incidence":"12182",
"percent":"0.039568413",
"ratio":"2527",
"rank":"467",
"jurisdiction":"Uzbekistan",
"iso":"uz"
},
{
"incidence":"10747",
"percent":"0.437090596",
"ratio":"229",
"rank":"39",
"jurisdiction":"Slovenia",
"iso":"si"
},
{
"incidence":"8945",
"percent":"0.105063707",
"ratio":"952",
"rank":"190",
"jurisdiction":"Austria",
"iso":"at"
},
{
"incidence":"8462",
"percent":"0.154608416",
"ratio":"647",
"rank":"159",
"jurisdiction":"Turkmenistan",
"iso":"tm"
},
{
"incidence":"8094",
"percent":"0.047674521",
"ratio":"2098",
"rank":"261",
"jurisdiction":"Mali",
"iso":"ml"
},
{
"incidence":"7496",
"percent":"0.103512736",
"ratio":"966",
"rank":"235",
"jurisdiction":"Paraguay",
"iso":"py"
},
{
"incidence":"7388",
"percent":"0.040142121",
"ratio":"2491",
"rank":"363",
"jurisdiction":"Burkina Faso",
"iso":"bf"
},
{
"incidence":"6794",
"percent":"0.597159231",
"ratio":"167",
"rank":"39",
"jurisdiction":"Equatorial Guinea",
"iso":"gq"
},
{
"incidence":"6762",
"percent":"0.496687647",
"ratio":"201",
"rank":"3",
"jurisdiction":"Trinidad and Tobago",
"iso":"tt"
},
{
"incidence":"6540",
"percent":"0.115804335",
"ratio":"864",
"rank":"192",
"jurisdiction":"Denmark",
"iso":"dk"
},
{
"incidence":"6538",
"percent":"0.184152155",
"ratio":"543",
"rank":"108",
"jurisdiction":"Puerto Rico",
"iso":"pr"
},
{
"incidence":"5932",
"percent":"0.017269846",
"ratio":"5790",
"rank":"578",
"jurisdiction":"Morocco",
"iso":"ma"
},
{
"incidence":"5718",
"percent":"0.261659953",
"ratio":"382",
"rank":"45",
"jurisdiction":"Botswana",
"iso":"bw"
},
{
"incidence":"5590",
"percent":"0.962205464",
"ratio":"104",
"rank":"5",
"jurisdiction":"Solomon Islands",
"iso":"sb"
},
{
"incidence":"5181",
"percent":"0.275114923",
"ratio":"363",
"rank":"43",
"jurisdiction":"Gabon",
"iso":"ga"
},
{
"incidence":"5046",
"percent":"0.172882286",
"ratio":"578",
"rank":"124",
"jurisdiction":"Armenia",
"iso":"am"
},
{
"incidence":"4848",
"percent":"0.021008867",
"ratio":"4760",
"rank":"543",
"jurisdiction":"Ivory Coast",
"iso":"ci"
},
{
"incidence":"4807",
"percent":"0.201190654",
"ratio":"497",
"rank":"36",
"jurisdiction":"Qatar",
"iso":"qa"
},
{
"incidence":"4724",
"percent":"0.003688548",
"ratio":"27111",
"rank":"2036",
"jurisdiction":"Japan",
"iso":"jp"
},
{
"incidence":"4681",
"percent":"1.090400007",
"ratio":"92",
"rank":"7",
"jurisdiction":"Malta",
"iso":"mt"
},
{
"incidence":"4592",
"percent":"0.089463143",
"ratio":"1118",
"rank":"248",
"jurisdiction":"Norway",
"iso":"no"
},
{
"incidence":"4370",
"percent":"0.226824811",
"ratio":"441",
"rank":"108",
"jurisdiction":"Gambia",
"iso":"gm"
},
{
"incidence":"4216",
"percent":"0.472464593",
"ratio":"212",
"rank":"7",
"jurisdiction":"Fiji",
"iso":"fj"
},
{
"incidence":"3867",
"percent":"1.334419181",
"ratio":"75",
"rank":"1",
"jurisdiction":"Barbados",
"iso":"bb"
},
{
"incidence":"3794",
"percent":"0.049547044",
"ratio":"2018",
"rank":"158",
"jurisdiction":"Hong Kong",
"iso":"hk"
},
{
"incidence":"3665",
"percent":"0.917640225",
"ratio":"109",
"rank":"6",
"jurisdiction":"Bahamas",
"iso":"bs"
},
{
"incidence":"3595",
"percent":"0.037554572",
"ratio":"2663",
"rank":"313",
"jurisdiction":"United Arab Emirates",
"iso":"ae"
},
{
"incidence":"3590",
"percent":"0.020220962",
"ratio":"4945",
"rank":"623",
"jurisdiction":"Kazakhstan",
"iso":"kz"
},
{
"incidence":"3567",
"percent":"0.079815728",
"ratio":"1253",
"rank":"199",
"jurisdiction":"Oman",
"iso":"om"
},
{
"incidence":"3472",
"percent":"0.055808424",
"ratio":"1792",
"rank":"371",
"jurisdiction":"Libya",
"iso":"ly"
},
{
"incidence":"3434",
"percent":"0.252221073",
"ratio":"396",
"rank":"40",
"jurisdiction":"Bahrain",
"iso":"bh"
},
{
"incidence":"3005",
"percent":"0.079366945",
"ratio":"1260",
"rank":"194",
"jurisdiction":"Kuwait",
"iso":"kw"
},
{
"incidence":"2896",
"percent":"0.012210276",
"ratio":"8190",
"rank":"1347",
"jurisdiction":"Taiwan",
"iso":"tw"
},
{
"incidence":"2756",
"percent":"0.073719722",
"ratio":"1356",
"rank":"264",
"jurisdiction":"Georgia",
"iso":"ge"
},
{
"incidence":"2749",
"percent":"0.359595066",
"ratio":"278",
"rank":"83",
"jurisdiction":"Comoros",
"iso":"km"
},
{
"incidence":"2733",
"percent":"0.210247751",
"ratio":"476",
"rank":"117",
"jurisdiction":"Swaziland",
"iso":"sz"
},
{
"incidence":"2641",
"percent":"1.009005016",
"ratio":"99",
"rank":"4",
"jurisdiction":"Vanuatu",
"iso":"vu"
},
{
"incidence":"2573",
"percent":"0.337106180",
"ratio":"297",
"rank":"7",
"jurisdiction":"Guyana",
"iso":"gy"
},
{
"incidence":"2496",
"percent":"0.005485734",
"ratio":"18229",
"rank":"336",
"jurisdiction":"Ukraine",
"iso":"ua"
},
{
"incidence":"2432",
"percent":"0.029036625",
"ratio":"3444",
"rank":"645",
"jurisdiction":"Tajikistan",
"iso":"tj"
},
{
"incidence":"2376",
"percent":"0.042220702",
"ratio":"2369",
"rank":"449",
"jurisdiction":"Lebanon",
"iso":"lb"
},
{
"incidence":"2352",
"percent":"0.021508812",
"ratio":"4649",
"rank":"374",
"jurisdiction":"Greece",
"iso":"gr"
},
{
"incidence":"2328",
"percent":"0.003375536",
"ratio":"29625",
"rank":"2889",
"jurisdiction":"Thailand",
"iso":"th"
},
{
"incidence":"2260",
"percent":"0.040761695",
"ratio":"2453",
"rank":"529",
"jurisdiction":"South Korea",
"iso":"kr"
},
{
"incidence":"2192",
"percent":"0.023113522",
"ratio":"4326",
"rank":"324",
"jurisdiction":"Belarus",
"iso":"by"
},
{
"incidence":"2131",
"percent":"0.062166849",
"ratio":"1609",
"rank":"243",
"jurisdiction":"Uruguay",
"iso":"uy"
},
{
"incidence":"2125",
"percent":"0.019034308",
"ratio":"5254",
"rank":"730",
"jurisdiction":"Tunisia",
"iso":"tn"
},
{
"incidence":"2122",
"percent":"0.006059668",
"ratio":"16503",
"rank":"1030",
"jurisdiction":"Iraq",
"iso":"iq"
},
{
"incidence":"2054",
"percent":"2.057229851",
"ratio":"49",
"rank":"2",
"jurisdiction":"Jersey",
"iso":"je"
},
{
"incidence":"2032",
"percent":"0.005321754",
"ratio":"18791",
"rank":"1144",
"jurisdiction":"Algeria",
"iso":"dz"
},
{
"incidence":"1989",
"percent":"0.047162228",
"ratio":"2120",
"rank":"352",
"jurisdiction":"Croatia",
"iso":"hr"
},
{
"incidence":"1922",
"percent":"0.094216656",
"ratio":"1061",
"rank":"133",
"jurisdiction":"Lesotho",
"iso":"ls"
},
{
"incidence":"1840",
"percent":"0.018790890",
"ratio":"5322",
"rank":"264",
"jurisdiction":"Hungary",
"iso":"hu"
},
{
"incidence":"1833",
"percent":"0.517362552",
"ratio":"193",
"rank":"7",
"jurisdiction":"Belize",
"iso":"bz"
},
{
"incidence":"1765",
"percent":"0.000951127",
"ratio":"105138",
"rank":"4361",
"jurisdiction":"Pakistan",
"iso":"pk"
},
{
"incidence":"1763",
"percent":"2.073873662",
"ratio":"48",
"rank":"4",
"jurisdiction":"Isle of Man",
"iso":"im"
},
{
"incidence":"1674",
"percent":"0.858061110",
"ratio":"117",
"rank":"5",
"jurisdiction":"Samoa",
"iso":"ws"
},
{
"incidence":"1653",
"percent":"0.612068072",
"ratio":"163",
"rank":"21",
"jurisdiction":"New Caledonia",
"iso":"nc"
},
{
"incidence":"1530",
"percent":"1.436943537",
"ratio":"70",
"rank":"9",
"jurisdiction":"Micronesia",
"iso":"fm"
},
{
"incidence":"1415",
"percent":"0.250977749",
"ratio":"398",
"rank":"90",
"jurisdiction":"Luxembourg",
"iso":"lu"
},
{
"incidence":"1269",
"percent":"0.035627323",
"ratio":"2807",
"rank":"282",
"jurisdiction":"Moldova",
"iso":"md"
},
{
"incidence":"1241",
"percent":"0.008509319",
"ratio":"11752",
"rank":"843",
"jurisdiction":"Senegal",
"iso":"sn"
},
{
"incidence":"1240",
"percent":"0.770368161",
"ratio":"130",
"rank":"5",
"jurisdiction":"Guam",
"iso":"gu"
},
{
"incidence":"1225",
"percent":"1.935106786",
"ratio":"52",
"rank":"1",
"jurisdiction":"Guernsey",
"iso":"gg"
},
{
"incidence":"1108",
"percent":"0.015850329",
"ratio":"6309",
"rank":"759",
"jurisdiction":"Bulgaria",
"iso":"bg"
},
{
"incidence":"1099",
"percent":"0.395642532",
"ratio":"253",
"rank":"29",
"jurisdiction":"French Polynesia",
"iso":"pf"
},
{
"incidence":"1075",
"percent":"0.194661389",
"ratio":"514",
"rank":"64",
"jurisdiction":"Suriname",
"iso":"sr"
},
{
"incidence":"1043",
"percent":"0.119016646",
"ratio":"840",
"rank":"136",
"jurisdiction":"Cyprus",
"iso":"cy"
},
{
"incidence":"1036",
"percent":"0.964151435",
"ratio":"104",
"rank":"14",
"jurisdiction":"Tonga",
"iso":"to"
},
{
"incidence":"1021",
"percent":"0.007548505",
"ratio":"13248",
"rank":"1160",
"jurisdiction":"Somalia",
"iso":"so"
},
{
"incidence":"953",
"percent":"0.009882904",
"ratio":"10118",
"rank":"1286",
"jurisdiction":"Azerbaijan",
"iso":"az"
},
{
"incidence":"913",
"percent":"0.012775964",
"ratio":"7827",
"rank":"753",
"jurisdiction":"Serbia",
"iso":"rs"
},
{
"incidence":"898",
"percent":"1.385203924",
"ratio":"72",
"rank":"2",
"jurisdiction":"Bermuda",
"iso":"bm"
},
{
"incidence":"859",
"percent":"0.066150503",
"ratio":"1512",
"rank":"260",
"jurisdiction":"Mauritius",
"iso":"mu"
},
{
"incidence":"853",
"percent":"0.777405126",
"ratio":"129",
"rank":"5",
"jurisdiction":"United States Virgin Islands",
"iso":"vi"
},
{
"incidence":"836",
"percent":"0.015248181",
"ratio":"6558",
"rank":"661",
"jurisdiction":"Finland",
"iso":"fi"
},
{
"incidence":"762",
"percent":"0.704694263",
"ratio":"142",
"rank":"10",
"jurisdiction":"Grenada",
"iso":"gd"
},
{
"incidence":"750",
"percent":"0.057024073",
"ratio":"1754",
"rank":"392",
"jurisdiction":"Estonia",
"iso":"ee"
},
{
"incidence":"667",
"percent":"0.723348878",
"ratio":"138",
"rank":"7",
"jurisdiction":"Seychelles",
"iso":"sc"
},
{
"incidence":"662",
"percent":"0.002011328",
"ratio":"49718",
"rank":"2561",
"jurisdiction":"Afghanistan",
"iso":"af"
},
{
"incidence":"633",
"percent":"0.003888670",
"ratio":"25716",
"rank":"2136",
"jurisdiction":"Cambodia",
"iso":"kh"
},
{
"incidence":"619",
"percent":"0.000668277",
"ratio":"149639",
"rank":"1148",
"jurisdiction":"Vietnam",
"iso":"vn"
},
{
"incidence":"610",
"percent":"0.115270943",
"ratio":"868",
"rank":"139",
"jurisdiction":"Cape Verde",
"iso":"cv"
},
{
"incidence":"605",
"percent":"0.144238220",
"ratio":"693",
"rank":"63",
"jurisdiction":"Brunei",
"iso":"bn"
},
{
"incidence":"579",
"percent":"0.325617492",
"ratio":"307",
"rank":"22",
"jurisdiction":"Saint Lucia",
"iso":"lc"
},
{
"incidence":"576",
"percent":"0.010847329",
"ratio":"9219",
"rank":"410",
"jurisdiction":"Slovakia",
"iso":"sk"
},
{
"incidence":"571",
"percent":"2.630124367",
"ratio":"38",
"rank":"15",
"jurisdiction":"Palau",
"iso":"pw"
},
{
"incidence":"562",
"percent":"0.916817566",
"ratio":"109",
"rank":"5",
"jurisdiction":"Cayman Islands",
"iso":"ky"
},
{
"incidence":"550",
"percent":"0.015605675",
"ratio":"6408",
"rank":"972",
"jurisdiction":"Bosnia and Herzegovina",
"iso":"ba"
},
{
"incidence":"537",
"percent":"0.711446741",
"ratio":"141",
"rank":"28",
"jurisdiction":"Dominica",
"iso":"dm"
},
{
"incidence":"535",
"percent":"0.538429798",
"ratio":"186",
"rank":"4",
"jurisdiction":"Antigua and Barbuda",
"iso":"ag"
},
{
"incidence":"516",
"percent":"0.621492063",
"ratio":"161",
"rank":"27",
"jurisdiction":"Andorra",
"iso":"ad"
},
{
"incidence":"452",
"percent":"0.405090518",
"ratio":"247",
"rank":"2",
"jurisdiction":"Saint Vincent and the Grenadines",
"iso":"vc"
},
{
"incidence":"435",
"percent":"1.280014124",
"ratio":"78",
"rank":"3",
"jurisdiction":"Gibraltar",
"iso":"gi"
},
{
"incidence":"419",
"percent":"0.765674397",
"ratio":"131",
"rank":"8",
"jurisdiction":"Northern Mariana Islands",
"iso":"mp"
},
{
"incidence":"343",
"percent":"0.037453347",
"ratio":"2670",
"rank":"362",
"jurisdiction":"Djibouti",
"iso":"dj"
},
{
"incidence":"342",
"percent":"0.301603259",
"ratio":"332",
"rank":"100",
"jurisdiction":"Kiribati",
"iso":"ki"
},
{
"incidence":"330",
"percent":"0.317027245",
"ratio":"315",
"rank":"21",
"jurisdiction":"Aruba",
"iso":"aw"
},
{
"incidence":"318",
"percent":"0.010869209",
"ratio":"9200",
"rank":"1103",
"jurisdiction":"Albania",
"iso":"al"
},
{
"incidence":"305",
"percent":"0.010391713",
"ratio":"9623",
"rank":"1483",
"jurisdiction":"Mongolia",
"iso":"mn"
},
{
"incidence":"272",
"percent":"0.000349655",
"ratio":"285997",
"rank":"5264",
"jurisdiction":"Turkey",
"iso":"tr"
},
{
"incidence":"266",
"percent":"0.766217306",
"ratio":"131",
"rank":"4",
"jurisdiction":"Turks and Caicos Islands",
"iso":"tc"
},
{
"incidence":"251",
"percent":"0.068559754",
"ratio":"1459",
"rank":"275",
"jurisdiction":"Iceland",
"iso":"is"
},
{
"incidence":"244",
"percent":"0.476283428",
"ratio":"210",
"rank":"3",
"jurisdiction":"Marshall Islands",
"iso":"mh"
},
{
"incidence":"235",
"percent":"0.000762664",
"ratio":"131119",
"rank":"6557",
"jurisdiction":"Saudi Arabia",
"iso":"sa"
},
{
"incidence":"234",
"percent":"0.426625827",
"ratio":"234",
"rank":"12",
"jurisdiction":"Saint Kitts and Nevis",
"iso":"kn"
},
{
"incidence":"227",
"percent":"0.600195658",
"ratio":"167",
"rank":"3",
"jurisdiction":"Monaco",
"iso":"mc"
},
{
"incidence":"222",
"percent":"0.003716635",
"ratio":"26906",
"rank":"3044",
"jurisdiction":"Kyrgyzstan",
"iso":"kg"
},
{
"incidence":"219",
"percent":"0.007418669",
"ratio":"13480",
"rank":"708",
"jurisdiction":"Lithuania",
"iso":"lt"
},
{
"incidence":"217",
"percent":"0.000276441",
"ratio":"361740",
"rank":"5086",
"jurisdiction":"Iran",
"iso":"ir"
},
{
"incidence":"191",
"percent":"0.340876642",
"ratio":"293",
"rank":"7",
"jurisdiction":"American Samoa",
"iso":"as"
},
{
"incidence":"183",
"percent":"0.514131595",
"ratio":"195",
"rank":"63",
"jurisdiction":"Saint Martin",
"iso":"mf"
},
{
"incidence":"182",
"percent":"0.009777377",
"ratio":"10228",
"rank":"1487",
"jurisdiction":"Kosovo",
"iso":"xk"
},
{
"incidence":"179",
"percent":"0.317860568",
"ratio":"315",
"rank":"59",
"jurisdiction":"Greenland",
"iso":"gl"
},
{
"incidence":"174",
"percent":"0.071479922",
"ratio":"1399",
"rank":"284",
"jurisdiction":"Abkhazia",
"iso":"ge-ab"
},
{
"incidence":"158",
"percent":"0.505567644",
"ratio":"198",
"rank":"3",
"jurisdiction":"British Virgin Islands",
"iso":"vg"
},
{
"incidence":"137",
"percent":"1.187895604",
"ratio":"84",
"rank":"4",
"jurisdiction":"Nauru",
"iso":"nr"
},
{
"incidence":"131",
"percent":"1.371009942",
"ratio":"73",
"rank":"13",
"jurisdiction":"Saint Barthelemy",
"iso":"bl"
},
{
"incidence":"129",
"percent":"0.006396966",
"ratio":"15632",
"rank":"825",
"jurisdiction":"Latvia",
"iso":"lv"
},
{
"incidence":"123",
"percent":"0.025864135",
"ratio":"3866",
"rank":"341",
"jurisdiction":"Transnistria",
"iso":"md-tr"
},
{
"incidence":"111",
"percent":"0.018267004",
"ratio":"5474",
"rank":"244",
"jurisdiction":"Macau",
"iso":"mo"
},
{
"incidence":"110",
"percent":"0.000573395",
"ratio":"174400",
"rank":"5217",
"jurisdiction":"Niger",
"iso":"ne"
},
{
"incidence":"109",
"percent":"0.600451716",
"ratio":"167",
"rank":"15",
"jurisdiction":"Cook Islands",
"iso":"ck"
},
{
"incidence":"108",
"percent":"0.017017575",
"ratio":"5876",
"rank":"815",
"jurisdiction":"Montenegro",
"iso":"me"
},
{
"incidence":"101",
"percent":"0.746378954",
"ratio":"134",
"rank":"26",
"jurisdiction":"Wallis and Futuna",
"iso":"wf"
},
{
"incidence":"98",
"percent":"0.000188649",
"ratio":"530084",
"rank":"615",
"jurisdiction":"Myanmar",
"iso":"mm"
},
{
"incidence":"95",
"percent":"0.000333481",
"ratio":"299867",
"rank":"10932",
"jurisdiction":"Nepal",
"iso":"np"
},
{
"incidence":"95",
"percent":"1.629782124",
"ratio":"61",
"rank":"4",
"jurisdiction":"Saint Helena, Ascension and Tristan da Cunha",
"iso":"sh"
},
{
"incidence":"92",
"percent":"0.004400230",
"ratio":"22726",
"rank":"2265",
"jurisdiction":"North Macedonia",
"iso":"mk"
},
{
"incidence":"87",
"percent":"0.001518387",
"ratio":"65859",
"rank":"5992",
"jurisdiction":"Singapore",
"iso":"sg"
},
{
"incidence":"82",
"percent":"0.042707444",
"ratio":"2342",
"rank":"448",
"jurisdiction":"S\u00e3o Tom\u00e9 and Pr\u00edncipe",
"iso":"st"
},
{
"incidence":"75",
"percent":"0.000849670",
"ratio":"117693",
"rank":"2181",
"jurisdiction":"Jordan",
"iso":"jo"
},
{
"incidence":"59",
"percent":"0.000305370",
"ratio":"327471",
"rank":"2620",
"jurisdiction":"Syria",
"iso":"sy"
},
{
"incidence":"57",
"percent":"1.162790698",
"ratio":"86",
"rank":"7",
"jurisdiction":"Montserrat",
"iso":"ms"
},
{
"incidence":"52",
"percent":"0.392334390",
"ratio":"255",
"rank":"6",
"jurisdiction":"Anguilla",
"iso":"ai"
},
{
"incidence":"41",
"percent":"0.000622457",
"ratio":"160654",
"rank":"228",
"jurisdiction":"Laos",
"iso":"la"
},
{
"incidence":"41",
"percent":"0.000155881",
"ratio":"641515",
"rank":"2680",
"jurisdiction":"Yemen",
"iso":"ye"
},
{
"incidence":"40",
"percent":"1.721170396",
"ratio":"58",
"rank":"3",
"jurisdiction":"Norfolk Island",
"iso":"nf"
},
{
"incidence":"39",
"percent":"0.102820986",
"ratio":"973",
"rank":"210",
"jurisdiction":"Liechtenstein",
"iso":"li"
},
{
"incidence":"35",
"percent":"1.118925831",
"ratio":"89",
"rank":"8",
"jurisdiction":"Falkland Islands",
"iso":"fk"
},
{
"incidence":"29",
"percent":"0.457485408",
"ratio":"219",
"rank":"47",
"jurisdiction":"Saint Pierre and Miquelon",
"iso":"pm"
},
{
"incidence":"26",
"percent":"0.000571421",
"ratio":"175002",
"rank":"2270",
"jurisdiction":"Palestine",
"iso":"ps"
},
{
"incidence":"15",
"percent":"0.000366279",
"ratio":"273016",
"rank":"7154",
"jurisdiction":"Mauritania",
"iso":"mr"
},
{
"incidence":"14",
"percent":"0.042353653",
"ratio":"2361",
"rank":"323",
"jurisdiction":"San Marino",
"iso":"sm"
},
{
"incidence":"13",
"percent":"0.810473815",
"ratio":"123",
"rank":"22",
"jurisdiction":"Niue",
"iso":"nu"
},
{
"incidence":"12",
"percent":"0.002761713",
"ratio":"36209",
"rank":"1317",
"jurisdiction":"Maldives",
"iso":"mv"
},
{
"incidence":"9",
"percent":"0.018319492",
"ratio":"5459",
"rank":"808",
"jurisdiction":"Faroe Islands",
"iso":"fo"
},
{
"incidence":"4",
"percent":"0.035270258",
"ratio":"2835",
"rank":"47",
"jurisdiction":"Tuvalu",
"iso":"tv"
},
{
"incidence":"1",
"percent":"0.000121217",
"ratio":"824969",
"rank":"6865",
"jurisdiction":"Bhutan",
"iso":"bt"
},
{
"incidence":"1",
"percent":"1.923076923",
"ratio":"52",
"rank":"1",
"jurisdiction":"Pitcairn Islands",
"iso":"pn"
},
{
"incidence":"1",
"percent":"0.001867379",
"ratio":"53551",
"rank":"905",
"jurisdiction":"South Ossetia",
"iso":"ge-so"
},
{
"incidence":"1",
"percent":"0.813008130",
"ratio":"123",
"rank":"15",
"jurisdiction":"Vatican City",
"iso":"va"
}
],
"world":{
"incidence":"12994361",
"percent":"0.178319213",
"ratio":"561",
"rank":"14"
},
"name":"David",
"type":"forename",
"remainingCredits":45171
}
{
jurisdictions: {
incidence: approximate number of people who bear the name in the jurisdiction,
percent: percentage of people in the jurisdiction who bear the name,
ratio: for every n people in this jurisdiction one bear the name,
rank: popularity rank of the name in the jurisdiction (uses ordinal ranking),
jurisdiction: name of the jurisdiction,
iso: two-character ISO country code or five/six-character ISO region code or Forebears region code,
id: id (if supplied)
},
world: {
incidence: approximate number of people who bear the name in the world,
percent: percentage of people in the world who bear the name,
ratio: for every n people in the world one bear the name,
rank popularity rank of the name in the jurisdiction (uses ordinal ranking):
},
name: name supplied,
type: type supplied,
sanitizedName: sanitized name (if sanitize was enabled),
status: [array of error messages and notices],
remainingCredits: number of API credits remaining
}
See the list of countries/jurisdictions.
Example request to get data for the forename Hopkin (with gender):
{
"jurisdictions":[
{
"incidence":"36",
"percent":"0.006196672",
"ratio":"16138",
"rank":"1393",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"Solomon Islands",
"iso":"sb"
},
{
"incidence":"19",
"percent":"0.000005235",
"ratio":"19102901",
"rank":"157759",
"gender":null,
"genderPercent":null,
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"7",
"percent":"0.000000511",
"ratio":"195819000",
"rank":"75330",
"gender":null,
"genderPercent":null,
"jurisdiction":"China",
"iso":"cn"
},
{
"incidence":"7",
"percent":"0.000226211",
"ratio":"442065",
"rank":"6012",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"Wales",
"iso":"gb-wls"
},
{
"incidence":"5",
"percent":"0.000001938",
"ratio":"51592737",
"rank":"871496",
"gender":null,
"genderPercent":null,
"jurisdiction":"Indonesia",
"iso":"id"
},
{
"incidence":"4",
"percent":"0.000003772",
"ratio":"26513250",
"rank":"280924",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"Philippines",
"iso":"ph"
},
{
"incidence":"3",
"percent":"0.000005387",
"ratio":"18564231",
"rank":"105465",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"2",
"percent":"0.000004319",
"ratio":"23153815",
"rank":"56668",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"Kenya",
"iso":"ke"
},
{
"incidence":"2",
"percent":"0.000004876",
"ratio":"20510352",
"rank":"92564",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"Uganda",
"iso":"ug"
},
{
"incidence":"2",
"percent":"0.000012584",
"ratio":"7946588",
"rank":"45785",
"gender":null,
"genderPercent":null,
"jurisdiction":"Zambia",
"iso":"zm"
},
{
"incidence":"1",
"percent":"0.000013059",
"ratio":"7657369",
"rank":"19488",
"gender":null,
"genderPercent":null,
"jurisdiction":"Hong Kong",
"iso":"hk"
},
{
"incidence":"1",
"percent":"0.000034688",
"ratio":"2882856",
"rank":"22303",
"gender":null,
"genderPercent":null,
"jurisdiction":"Jamaica",
"iso":"jm"
},
{
"incidence":"1",
"percent":"0.000022615",
"ratio":"4421851",
"rank":"36342",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"Liberia",
"iso":"lr"
},
{
"incidence":"1",
"percent":"0.000022046",
"ratio":"4535879",
"rank":"17376",
"gender":null,
"genderPercent":null,
"jurisdiction":"New Zealand",
"iso":"nz"
},
{
"incidence":"1",
"percent":"0.000000562",
"ratio":"177954184",
"rank":"490901",
"gender":"m",
"genderPercent":"100",
"jurisdiction":"Nigeria",
"iso":"ng"
}
],
"world":{
"incidence":"92",
"percent":"0.000001262",
"ratio":"79207984",
"rank":"957884"
},
"name":"Hopkin",
"type":"forename",
"remainingCredits":45169
}
Example request to get data for the surname Holzapfel in Austria:
{
"jurisdictions":[
{
"incidence":"266",
"percent":"0.017155834",
"ratio":"5829",
"rank":"821",
"jurisdiction":"Lower Austria",
"iso":"x-5ykf"
},
{
"incidence":"240",
"percent":"0.016958362",
"ratio":"5897",
"rank":"1018",
"jurisdiction":"Upper Austria",
"iso":"x-5ykj"
},
{
"incidence":"180",
"percent":"0.009768900",
"ratio":"10237",
"rank":"1472",
"jurisdiction":"Vienna",
"iso":"x-5ykk"
},
{
"incidence":"173",
"percent":"0.014250658",
"ratio":"7017",
"rank":"1240",
"jurisdiction":"Styria",
"iso":"x-5ykh"
},
{
"incidence":"88",
"percent":"0.030560755",
"ratio":"3272",
"rank":"620",
"jurisdiction":"Burgenland",
"iso":"x-5ykd"
},
{
"incidence":"32",
"percent":"0.005979867",
"ratio":"16723",
"rank":"2604",
"jurisdiction":"Salzburg",
"iso":"x-5ykg"
},
{
"incidence":"9",
"percent":"0.001248469",
"ratio":"80098",
"rank":"8439",
"jurisdiction":"Tyrol",
"iso":"x-5yki"
},
{
"incidence":"1",
"percent":"0.000266306",
"ratio":"375508",
"rank":"9166",
"jurisdiction":"Vorarlberg",
"iso":"x-5ykl"
}
],
"world":{
"incidence":"12917",
"percent":"0.000177258",
"ratio":"564151",
"rank":"40657"
},
"name":"Holzapfel",
"type":"surname",
"remainingCredits":45168
}
A number of errors are provided in the JSON result. They appear in the root of the JSON.
Errors and notices have three properties: type, code and message.
| Code | Message |
|---|---|
| 0001 | API key not supplied |
| 0006 | API key not recognised |
| 0007 | Out of credits |
| 0016 | Name not supplied |
| 0017 | Name type not supplied |
| 0018 | Recognised name is required |
| 0019 | Jurisdiction is not recognised |
| 0020 | Administrative division level must be between 1 and 4 |
| 0021 | Your account does not have permission to use the location API |
{
"status":[
{
"type":"error",
"code":"0001",
"message":"API key not supplied"
},
{
"type":"error",
"code":"0016",
"message":"Name not supplied"
},
{
"type":"error",
"code":"0019",
"message":"Jurisdiction is not recognised"
}
]
}