Description: Retrieves raw incidence in countries/jurisdictions and regions for up to 1,000 names.
API URL:
| Parameter | |
| key | your API key (string, 32) |
| Parameter | |
| names | a JSON encoded array of names (up to 1,000) |
The names POST parameter is an array of names that can take the following properties (with the same function as the single name API): name, type, sanitize, limit and id.
An example names POST property:
[{"name":"John","type":"forename","id":1,"sanitize":1,"limit":10},{"name":"Adams","type":"surname","id":2}]
<?php error_reporting( E_ALL ); ini_set( 'display_errors', 1 ); setlocale( LC_CTYPE, 'en_US.UTF-8' ); mb_regex_encoding( 'UTF-8' ); $apikey = 'YOUR_API_KEY'; $src = array( array( 'name' => 'John2', 'type' => 'forename', 'id' => 1, 'sanitize' => 1 ), array( 'name' => 'Kylie', 'type' => 'forename', 'id' => 2 ), array( 'name' => 'Vladimir', 'type' => 'forename', 'id' => 3 ), array( 'name' => 'Svetlana', 'type' => 'forename', 'id' => 4 ), array( 'name' => 'Aleksandar', 'type' => 'forename', 'id' => 5 ), array( 'name' => 'Googie', 'type' => 'forename', 'id' => 6 ), array( 'name' => 'Carlos', 'type' => 'forename','id' => 70 ), array( 'name' => 'Melanija', 'type' => 'forename', 'id' => 80 ), array( 'name' => 'Donald', 'type' => 'forename', 'id' => 90 ), array( 'name' => 'Michelle', 'type' => 'forename', 'id' => 1000 ), array( 'name' => 'Barrack', 'type' => 'forename', 'id' => 1100 ), array( 'name' => 'Tallulah', 'type' => 'forename', 'id' => 1200 ), array( 'name' => 'Thomas', 'type' => 'forename', 'id' => 1300 ), array( 'name' => 'Julie', 'type' => 'forename', 'id' => 1400 ), array( 'name' => 'Lianjie', 'type' => 'forename', 'id' => 1500 ), array( 'name' => 'Sara', 'type' => 'forename', 'id' => 1600 ), array( 'name' => 'Eric', 'type' => 'forename', 'id' => 1700 ), array( 'name' => 'Sheikh', 'type' => 'forename', 'id' => 1800 ), array( 'name' => 'Bob', 'type' => 'forename', 'id' => 1900 ), array( 'name' => 'Martha', 'type' => 'forename', 'id' => 2000 ), array( 'name' => 'Emmett-Hovhannes', 'type' => 'forename', 'id' => 2100 ), array( 'name' => 'Владимир', 'type' => 'forename', 'id' => 2101, 'sanitize' => 1 ), array( 'name' => 'VladimirВладимир', 'type' => 'forename', 'sanitize' => 1 ), array( 'name' => 'Dickens', 'type' => 'surname', 'id' => 1, 'sanitize' => 101 ), array( 'name' => 'Hemmingway', 'type' => 'surname', 'id' => 201 ), array( 'name' => 'Trump', 'type' => 'surname', 'id' => 301 ), array( 'name' => 'Modi', 'type' => 'surname', 'id' => 401 ), array( 'name' => 'Xi', 'type' => 'surname', 'id' => 501 ), array( 'name' => 'Nazarbayev', 'type' => 'surname', 'id' => 601 ), array( 'name' => 'Putin', 'type' => 'surname','id' => 701 ), array( 'name' => 'Waters', 'type' => 'surname', 'id' => 801 ) ); $j = json_encode( $src ); $url = 'https://ono.4b.rs/api/v1/jurs?limit=3&key='; $c = curl_init(); curl_setopt( $c, CURLOPT_URL, $url . $apikey ); curl_setopt( $c, CURLOPT_POST, 1 ); curl_setopt( $c, CURLOPT_POSTFIELDS, 'names=' . $j ); curl_setopt( $c, CURLOPT_RETURNTRANSFER, true ); $out = curl_exec( $c ); curl_close ( $c ); $nl = ( php_sapi_name() == 'cli' ) ? "\n" : '<br /&get'; $j = json_decode( $out ); foreach( $j->results as $person ) { if( isset( $person->id ) ) echo '(' . $person->id . ') '; echo $person->name . ' (' . $person->type . ')'; echo $nl; if( isset( $person->jurisdictions[0] ) ) { echo 'Most likely from: '; echo $person->jurisdictions[0]->jurisdiction . $nl; } if( isset( $person->jurisdictions[1] ) ) { echo '2nd most likely from: '; echo $person->jurisdictions[1]->jurisdiction . $nl; } if( !isset( $person->jurisdictions[0] ) ) echo 'No data found' . $nl; echo '------------------------------------------------------------------------------------' . $nl; } ?>
Replace $apikey on line 8 with your API key.
{
"results":[
{
"jurisdictions":[
{
"incidence":"5470092",
"percent":"1.507098721",
"ratio":"66",
"rank":"1",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"1108241",
"percent":"1.989921694",
"ratio":"50",
"rank":"2",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"834888",
"percent":"0.469158961",
"ratio":"213",
"rank":"23",
"jurisdiction":"Nigeria",
"iso":"ng"
}
],
"world":{
"incidence":"13913286",
"percent":"0.190929451",
"ratio":"524",
"rank":"13"
},
"name":"John2",
"type":"forename",
"sanitizedName":"John",
"id":1
},
{
"jurisdictions":[
{
"incidence":"41865",
"percent":"0.294117936",
"ratio":"340",
"rank":"65",
"jurisdiction":"Australia",
"iso":"au"
},
{
"incidence":"11777",
"percent":"0.003244754",
"ratio":"30819",
"rank":"2105",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"6294",
"percent":"0.011301303",
"ratio":"8849",
"rank":"738",
"jurisdiction":"England",
"iso":"gb-eng"
}
],
"world":{
"incidence":"71774",
"percent":"0.000984941",
"ratio":"101529",
"rank":"13608"
},
"name":"Kylie",
"type":"forename",
"sanitizedName":"Kylie",
"id":2
},
{
"jurisdictions":[
{
"incidence":"1812228",
"percent":"1.255800591",
"ratio":"80",
"rank":"14",
"jurisdiction":"Russia",
"iso":"ru"
},
{
"incidence":"1661762",
"percent":"3.652237019",
"ratio":"27",
"rank":"2",
"jurisdiction":"Ukraine",
"iso":"ua"
},
{
"incidence":"213716",
"percent":"0.694171965",
"ratio":"144",
"rank":"9",
"jurisdiction":"Uzbekistan",
"iso":"uz"
}
],
"world":{
"incidence":"4456494",
"percent":"0.061155643",
"ratio":"1635",
"rank":"86"
},
"name":"Vladimir",
"type":"forename",
"sanitizedName":"Vladimir",
"id":3
},
{
"jurisdictions":[
{
"incidence":"2546286",
"percent":"1.764473048",
"ratio":"57",
"rank":"9",
"jurisdiction":"Russia",
"iso":"ru"
},
{
"incidence":"864511",
"percent":"1.900030857",
"ratio":"53",
"rank":"17",
"jurisdiction":"Ukraine",
"iso":"ua"
},
{
"incidence":"211761",
"percent":"0.687821920",
"ratio":"145",
"rank":"12",
"jurisdiction":"Uzbekistan",
"iso":"uz"
}
],
"world":{
"incidence":"4374383",
"percent":"0.060028849",
"ratio":"1666",
"rank":"91"
},
"name":"Svetlana",
"type":"forename",
"sanitizedName":"Svetlana",
"id":4
},
{
"jurisdictions":[
{
"incidence":"74510",
"percent":"1.042647370",
"ratio":"96",
"rank":"7",
"jurisdiction":"Serbia",
"iso":"rs"
},
{
"incidence":"45789",
"percent":"0.655027737",
"ratio":"153",
"rank":"18",
"jurisdiction":"Bulgaria",
"iso":"bg"
},
{
"incidence":"13858",
"percent":"0.662808494",
"ratio":"151",
"rank":"4",
"jurisdiction":"North Macedonia",
"iso":"mk"
}
],
"world":{
"incidence":"164501",
"percent":"0.002257417",
"ratio":"44298",
"rank":"6397"
},
"name":"Aleksandar",
"type":"forename",
"sanitizedName":"Aleksandar",
"id":5
},
{
"jurisdictions":[
{
"incidence":"7",
"percent":"0.000012569",
"ratio":"7956099",
"rank":"61037",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"6",
"percent":"0.000001653",
"ratio":"60492520",
"rank":"353848",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"2",
"percent":"0.000044093",
"ratio":"2267940",
"rank":"12368",
"jurisdiction":"New Zealand",
"iso":"nz"
}
],
"world":{
"incidence":"26",
"percent":"0.000000357",
"ratio":"280274405",
"rank":"2002026"
},
"name":"Googie",
"type":"forename",
"sanitizedName":"Googie",
"id":6
},
{
"jurisdictions":[
{
"incidence":"1819687",
"percent":"0.887801757",
"ratio":"113",
"rank":"7",
"jurisdiction":"Brazil",
"iso":"br"
},
{
"incidence":"1143521",
"percent":"0.921160597",
"ratio":"109",
"rank":"11",
"jurisdiction":"Mexico",
"iso":"mx"
},
{
"incidence":"894854",
"percent":"2.092088516",
"ratio":"48",
"rank":"4",
"jurisdiction":"Argentina",
"iso":"ar"
}
],
"world":{
"incidence":"9498945",
"percent":"0.130352266",
"ratio":"767",
"rank":"27"
},
"name":"Carlos",
"type":"forename",
"sanitizedName":"Carlos",
"id":70
},
{
"jurisdictions":[
{
"incidence":"1145",
"percent":"0.016022430",
"ratio":"6241",
"rank":"669",
"jurisdiction":"Serbia",
"iso":"rs"
},
{
"incidence":"528",
"percent":"0.017886106",
"ratio":"5591",
"rank":"504",
"jurisdiction":"Lithuania",
"iso":"lt"
},
{
"incidence":"485",
"percent":"0.011500091",
"ratio":"8696",
"rank":"721",
"jurisdiction":"Croatia",
"iso":"hr"
}
],
"world":{
"incidence":"3085",
"percent":"0.000042335",
"ratio":"2362118",
"rank":"127924"
},
"name":"Melanija",
"type":"forename",
"sanitizedName":"Melanija",
"id":80
},
{
"jurisdictions":[
{
"incidence":"1354844",
"percent":"0.373281411",
"ratio":"268",
"rank":"29",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"86568",
"percent":"0.259091363",
"ratio":"386",
"rank":"57",
"jurisdiction":"Canada",
"iso":"ca"
},
{
"incidence":"57824",
"percent":"0.103826904",
"ratio":"963",
"rank":"214",
"jurisdiction":"England",
"iso":"gb-eng"
}
],
"world":{
"incidence":"1775416",
"percent":"0.024363706",
"ratio":"4104",
"rank":"383"
},
"name":"Donald",
"type":"forename",
"sanitizedName":"Donald",
"id":90
},
{
"jurisdictions":[
{
"incidence":"1247847",
"percent":"0.343802009",
"ratio":"291",
"rank":"33",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"261153",
"percent":"0.246247626",
"ratio":"406",
"rank":"42",
"jurisdiction":"Philippines",
"iso":"ph"
},
{
"incidence":"199716",
"percent":"0.358603590",
"ratio":"279",
"rank":"50",
"jurisdiction":"England",
"iso":"gb-eng"
}
],
"world":{
"incidence":"2490001",
"percent":"0.034169823",
"ratio":"2927",
"rank":"239"
},
"name":"Michelle",
"type":"forename",
"sanitizedName":"Michelle",
"id":1000
},
{
"jurisdictions":[
{
"incidence":"1883",
"percent":"0.004066285",
"ratio":"24592",
"rank":"2246",
"jurisdiction":"Kenya",
"iso":"ke"
},
{
"incidence":"124",
"percent":"0.000724703",
"ratio":"137988",
"rank":"7247",
"jurisdiction":"Malawi",
"iso":"mw"
},
{
"incidence":"91",
"percent":"0.000221839",
"ratio":"450777",
"rank":"10957",
"jurisdiction":"Uganda",
"iso":"ug"
}
],
"world":{
"incidence":"2229",
"percent":"0.000030588",
"ratio":"3269239",
"rank":"155912"
},
"name":"Barrack",
"type":"forename",
"sanitizedName":"Barrack",
"id":1100
},
{
"jurisdictions":[
{
"incidence":"358",
"percent":"0.000098635",
"ratio":"1013841",
"rank":"21154",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"162",
"percent":"0.000290882",
"ratio":"343782",
"rank":"8220",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"53",
"percent":"0.000025858",
"ratio":"3867273",
"rank":"54513",
"jurisdiction":"Brazil",
"iso":"br"
}
],
"world":{
"incidence":"678",
"percent":"0.000009304",
"ratio":"10747986",
"rank":"311117"
},
"name":"Tallulah",
"type":"forename",
"sanitizedName":"Tallulah",
"id":1200
},
{
"jurisdictions":[
{
"incidence":"2507966",
"percent":"0.690985152",
"ratio":"145",
"rank":"9",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"1006726",
"percent":"1.028598930",
"ratio":"97",
"rank":"4",
"jurisdiction":"Germany",
"iso":"de"
},
{
"incidence":"338953",
"percent":"0.608613044",
"ratio":"164",
"rank":"18",
"jurisdiction":"England",
"iso":"gb-eng"
}
],
"world":{
"incidence":"6214078",
"percent":"0.085274643",
"ratio":"1173",
"rank":"51"
},
"name":"Thomas",
"type":"forename",
"sanitizedName":"Thomas",
"id":1300
},
{
"jurisdictions":[
{
"incidence":"864606",
"percent":"0.238212922",
"ratio":"420",
"rank":"64",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"304594",
"percent":"0.546919134",
"ratio":"183",
"rank":"25",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"220399",
"percent":"0.331477746",
"ratio":"302",
"rank":"83",
"jurisdiction":"France",
"iso":"fr"
}
],
"world":{
"incidence":"2338598",
"percent":"0.032092148",
"ratio":"3116",
"rank":"263"
},
"name":"Julie",
"type":"forename",
"sanitizedName":"Julie",
"id":1400
},
{
"jurisdictions":[
{
"incidence":"64261",
"percent":"0.004688076",
"ratio":"21331",
"rank":"3467",
"jurisdiction":"China",
"iso":"cn"
},
{
"incidence":"628",
"percent":"0.002647808",
"ratio":"37767",
"rank":"7902",
"jurisdiction":"Taiwan",
"iso":"tw"
},
{
"incidence":"404",
"percent":"0.007050899",
"ratio":"14183",
"rank":"2820",
"jurisdiction":"Singapore",
"iso":"sg"
}
],
"world":{
"incidence":"65323",
"percent":"0.000896415",
"ratio":"111555",
"rank":"14785"
},
"name":"Lianjie",
"type":"forename",
"sanitizedName":"Lianjie",
"id":1500
},
{
"jurisdictions":[
{
"incidence":"741139",
"percent":"0.806462801",
"ratio":"124",
"rank":"14",
"jurisdiction":"Egypt",
"iso":"eg"
},
{
"incidence":"442166",
"percent":"0.121823877",
"ratio":"821",
"rank":"171",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"399054",
"percent":"1.055499096",
"ratio":"95",
"rank":"7",
"jurisdiction":"Sudan",
"iso":"sd"
}
],
"world":{
"incidence":"4372341",
"percent":"0.060000827",
"ratio":"1667",
"rank":"92"
},
"name":"Sara",
"type":"forename",
"sanitizedName":"Sara",
"id":1600
},
{
"jurisdictions":[
{
"incidence":"1023519",
"percent":"0.281996020",
"ratio":"355",
"rank":"47",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"543778",
"percent":"0.817836315",
"ratio":"122",
"rank":"20",
"jurisdiction":"France",
"iso":"fr"
},
{
"incidence":"193344",
"percent":"0.716287831",
"ratio":"140",
"rank":"9",
"jurisdiction":"Ghana",
"iso":"gh"
}
],
"world":{
"incidence":"3495336",
"percent":"0.047965850",
"ratio":"2085",
"rank":"128"
},
"name":"Eric",
"type":"forename",
"sanitizedName":"Eric",
"id":1700
},
{
"jurisdictions":[
{
"incidence":"373709",
"percent":"0.234359512",
"ratio":"427",
"rank":"36",
"jurisdiction":"Bangladesh",
"iso":"bd"
},
{
"incidence":"149469",
"percent":"0.773616514",
"ratio":"129",
"rank":"23",
"jurisdiction":"Syria",
"iso":"sy"
},
{
"incidence":"127618",
"percent":"0.068771088",
"ratio":"1454",
"rank":"271",
"jurisdiction":"Pakistan",
"iso":"pk"
}
],
"world":{
"incidence":"851385",
"percent":"0.011683399",
"ratio":"8559",
"rank":"1113"
},
"name":"Sheikh",
"type":"forename",
"sanitizedName":"Sheikh",
"id":1800
},
{
"jurisdictions":[
{
"incidence":"488875",
"percent":"0.134692961",
"ratio":"742",
"rank":"146",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"75451",
"percent":"0.225819037",
"ratio":"443",
"rank":"74",
"jurisdiction":"Canada",
"iso":"ca"
},
{
"incidence":"30692",
"percent":"0.215623258",
"ratio":"464",
"rank":"104",
"jurisdiction":"Australia",
"iso":"au"
}
],
"world":{
"incidence":"782950",
"percent":"0.010744278",
"ratio":"9307",
"rank":"1231"
},
"name":"Bob",
"type":"forename",
"sanitizedName":"Bob",
"id":1900
},
{
"jurisdictions":[
{
"incidence":"981274",
"percent":"0.790462916",
"ratio":"127",
"rank":"13",
"jurisdiction":"Mexico",
"iso":"mx"
},
{
"incidence":"645284",
"percent":"0.177786167",
"ratio":"562",
"rank":"102",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"490168",
"percent":"1.025892801",
"ratio":"97",
"rank":"9",
"jurisdiction":"Colombia",
"iso":"co"
}
],
"world":{
"incidence":"4410855",
"percent":"0.060529348",
"ratio":"1652",
"rank":"89"
},
"name":"Martha",
"type":"forename",
"sanitizedName":"Martha",
"id":2000
},
{
"name":"Emmett-Hovhannes",
"type":"forename",
"sanitizedName":"Emmett-Hovhannes",
"status":[
{
"type":"error",
"code":"0018",
"message":"Recognised name is required"
}
],
"id":2100
},
{
"name":"\u0412\u043b\u0430\u0434\u0438\u043c\u0438\u0440",
"type":"forename",
"status":[
{
"type":"error",
"code":"0018",
"message":"Recognised name is required"
},
{
"type":"error",
"code":"0004",
"message":"Sanitized name is empty: \u0412\u043b\u0430\u0434\u0438\u043c\u0438\u0440"
}
],
"id":2101
},
{
"jurisdictions":[
{
"incidence":"1812228",
"percent":"1.255800591",
"ratio":"80",
"rank":"14",
"jurisdiction":"Russia",
"iso":"ru"
},
{
"incidence":"1661762",
"percent":"3.652237019",
"ratio":"27",
"rank":"2",
"jurisdiction":"Ukraine",
"iso":"ua"
},
{
"incidence":"213716",
"percent":"0.694171965",
"ratio":"144",
"rank":"9",
"jurisdiction":"Uzbekistan",
"iso":"uz"
}
],
"world":{
"incidence":"4456494",
"percent":"0.061155643",
"ratio":"1635",
"rank":"86"
},
"name":"Vladimir\u0412\u043b\u0430\u0434\u0438\u043c\u0438\u0440",
"type":"forename",
"sanitizedName":"Vladimir"
},
{
"jurisdictions":[
{
"incidence":"24731",
"percent":"0.006822147",
"ratio":"14658",
"rank":"1826",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"6681",
"percent":"0.011990730",
"ratio":"8340",
"rank":"1219",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"1336",
"percent":"0.004948935",
"ratio":"20206",
"rank":"2785",
"jurisdiction":"Australia",
"iso":"au"
}
],
"world":{
"incidence":"37966",
"percent":"0.000521000",
"ratio":"191938",
"rank":"14726"
},
"name":"Dickens",
"type":"surname",
"sanitizedName":"Dickens",
"id":1
},
{
"jurisdictions":[
{
"incidence":"722",
"percent":"0.000199167",
"ratio":"502092",
"rank":"42110",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"309",
"percent":"0.000554578",
"ratio":"180317",
"rank":"16254",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"94",
"percent":"0.000255118",
"ratio":"391975",
"rank":"34745",
"jurisdiction":"Canada",
"iso":"ca"
}
],
"world":{
"incidence":"1257",
"percent":"0.000017250",
"ratio":"5797243",
"rank":"301622"
},
"name":"Hemmingway",
"type":"surname",
"sanitizedName":"Hemmingway",
"id":201
},
{
"jurisdictions":[
{
"incidence":"5118",
"percent":"0.001411821",
"ratio":"70831",
"rank":"8174",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"897",
"percent":"0.001114210",
"ratio":"89750",
"rank":"11296",
"jurisdiction":"Germany",
"iso":"de"
},
{
"incidence":"551",
"percent":"0.000988908",
"ratio":"101122",
"rank":"10641",
"jurisdiction":"England",
"iso":"gb-eng"
}
],
"world":{
"incidence":"7235",
"percent":"0.000099285",
"ratio":"1007206",
"rank":"68855"
},
"name":"Trump",
"type":"surname",
"sanitizedName":"Trump",
"id":301
},
{
"jurisdictions":[
{
"incidence":"186638",
"percent":"0.024331448",
"ratio":"4110",
"rank":"386",
"jurisdiction":"India",
"iso":"in"
},
{
"incidence":"13932",
"percent":"0.007865492",
"ratio":"12714",
"rank":"1292",
"jurisdiction":"Nigeria",
"iso":"ng"
},
{
"incidence":"13720",
"percent":"0.036576586",
"ratio":"2734",
"rank":"389",
"jurisdiction":"Sudan",
"iso":"sd"
}
],
"world":{
"incidence":"251151",
"percent":"0.003446499",
"ratio":"29015",
"rank":"2194"
},
"name":"Modi",
"type":"surname",
"sanitizedName":"Modi",
"id":401
},
{
"jurisdictions":[
{
"incidence":"762738",
"percent":"0.055785313",
"ratio":"1793",
"rank":"150",
"jurisdiction":"China",
"iso":"cn"
},
{
"incidence":"3377",
"percent":"0.003645055",
"ratio":"27434",
"rank":"432",
"jurisdiction":"Vietnam",
"iso":"vn"
},
{
"incidence":"1882",
"percent":"0.008042477",
"ratio":"12434",
"rank":"218",
"jurisdiction":"Taiwan",
"iso":"tw"
}
],
"world":{
"incidence":"772846",
"percent":"0.010605623",
"ratio":"9429",
"rank":"696"
},
"name":"Xi",
"type":"surname",
"sanitizedName":"Xi",
"id":501
},
{
"jurisdictions":[
{
"incidence":"224",
"percent":"0.000723931",
"ratio":"138135",
"rank":"17746",
"jurisdiction":"Uzbekistan",
"iso":"uz"
},
{
"incidence":"106",
"percent":"0.000612718",
"ratio":"163207",
"rank":"15623",
"jurisdiction":"Kazakhstan",
"iso":"kz"
},
{
"incidence":"3",
"percent":"0.000002077",
"ratio":"48150575",
"rank":"640745",
"jurisdiction":"Russia",
"iso":"ru"
}
],
"world":{
"incidence":"336",
"percent":"0.000004611",
"ratio":"21687900",
"rank":"821977"
},
"name":"Nazarbayev",
"type":"surname",
"sanitizedName":"Nazarbayev",
"id":601
},
{
"jurisdictions":[
{
"incidence":"6424",
"percent":"0.004447160",
"ratio":"22486",
"rank":"3164",
"jurisdiction":"Russia",
"iso":"ru"
},
{
"incidence":"559",
"percent":"0.001806596",
"ratio":"55353",
"rank":"8132",
"jurisdiction":"Uzbekistan",
"iso":"uz"
},
{
"incidence":"221",
"percent":"0.000332755",
"ratio":"300522",
"rank":"45914",
"jurisdiction":"France",
"iso":"fr"
}
],
"world":{
"incidence":"8688",
"percent":"0.000119224",
"ratio":"838759",
"rank":"58431"
},
"name":"Putin",
"type":"surname",
"sanitizedName":"Putin",
"id":701
},
{
"jurisdictions":[
{
"incidence":"93142",
"percent":"0.025693600",
"ratio":"3892",
"rank":"423",
"jurisdiction":"United States",
"iso":"us"
},
{
"incidence":"19296",
"percent":"0.034631511",
"ratio":"2888",
"rank":"386",
"jurisdiction":"England",
"iso":"gb-eng"
},
{
"incidence":"13768",
"percent":"0.051000704",
"ratio":"1961",
"rank":"251",
"jurisdiction":"Australia",
"iso":"au"
}
],
"world":{
"incidence":"141059",
"percent":"0.001935727",
"ratio":"51660",
"rank":"3973"
},
"name":"Waters",
"type":"surname",
"sanitizedName":"Waters",
"id":801
}
],
"remainingCredits":86152,
"usedCredits":29
}
{
result:[
{
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 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),
},
name: name supplied,
type: type supplied,
sanitizedName: sanitized name (if sanitize was enabled),
status: [array of error messages and notices],
}
]
status: [array of error messages and notices],
remainingCredits: number of API credits remaining,
usedCredits: number of credits used for batch
}
A number of errors and notices are provided in the JSON result. They appear in the root of the JSON and in the root of each name response.
Errors and notices have three properties: type, code and message.
| Code | Message |
|---|---|
| 0001 | API key not supplied |
| 0006 | API key not recognized |
| 0007 | Out of credits |
| 0012 | Names JSON not supplied |
| 0013 | Names JSON is invalid |
| 0014 | Names JSON can't contain more than 1000 queries |
| 0016 | Name not supplied |
| 0017 | Name type not supplied |
| 0018 | Recognized name is required |
| 0019 | Jurisdiction is not recognized |
| 0020 | Administrative division level must be between 1 and 4 |
| 0021 | Your account does not have permission to use the location API |
| Code | Message |
|---|---|
| 0015 | Ran out of queries during execution |
{
"results":[
{
"forename":"Madeup",
"surname":"Unknown-Surname",
"secondSurname":null,
"status":[
{
"type":"notice",
"code":"0009",
"message":"Unknown surname supplied"
},
{
"type":"error",
"code":"0011",
"message":"Recognised forename and surname are required"
}
],
"id":1
},
{
"forename":"runcible",
"surname":"surname",
"secondSurname":null,
"status":[
{
"type":"notice",
"code":"0008",
"message":"Unknown forename supplied"
},
{
"type":"error",
"code":"0011",
"message":"Recognised forename and surname are required"
}
],
"id":2
},
{
"forename":"namethatdoesnotexist",
"surname":"surname-not-in-existance",
"secondSurname":null,
"status":[
{
"type":"notice",
"code":"0008",
"message":"Unknown forename supplied"
},
{
"type":"notice",
"code":"0009",
"message":"Unknown surname supplied"
},
{
"type":"error",
"code":"0011",
"message":"Recognised forename and surname are required"
}
],
"id":3
}
],
"remainingCredits":99301
}