DOCS API
CONSULTA MÚLTIPLES NOMBRES
A veces es necesario buscar varios nombres con una sola consulta:
Créditos requeridos: 1 crédito por cada nombre
Solicitar
Sin código de país
GET https://gender-api.com/get?name=lisa;jess;thomas&multi=true&key=<your private server key>
Solicitar
Con el código de país
GET https://gender-api.com/get?name=anna;jack;stephen&country=DE;US;CA&multi=true&key=<your private server key>
Campo | Escriba | Descripción |
---|---|---|
name | String | Lista separada por punto y coma de nombres a consultar |
country | String | Lista de códigos de país separados por punto y coma. Los códigos de país deben estar en el mismo orden que los nombres. Si sólo se proporciona un código de país, éste se utilizará para todos los nombres. |
multi | Boolean (true|false) | Le dice al API que devuelva el resultado como una matriz |
key | String | La clave de su servidor privado |
Respuesta
Sin código de país
{"name":"lisa;jess;thomas","result":[
{"name":"lisa","name_sanitized":"Lisa","country":"","gender":"female","samples":806,"accuracy":98},
{"name":"jess","name_sanitized":"Jess","country":"","gender":"female","samples":28,"accuracy":75},
{"name":"thomas","name_sanitized":"Thomas","country":"","gender":"male","samples":2239,"accuracy":99}],
"country":"","duration":"425ms","credits_used":3}
Respuesta
Con el código de país
{"name":"anna;jack;stephen","result":[
{"name":"anna","name_sanitized":"Anna","country":"DE","gender":"female","samples":1245,"accuracy":98},
{"name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90},
{"name":"stephen","name_sanitized":"Stephen","country":"CA","gender":"male","samples":77,"accuracy":82}],
"country":"DE;US;CA","duration":"668ms","credits_used":3}
Campo | Escriba | Descripción |
---|---|---|
name | String | Los nombres presentados en minúsculas. El número máximo de nombres está limitado a 100. |
result | Array | Véase la respuesta en "Uso simple" |
country | String | Lista presentada de códigos de países |
duration | String | El tiempo que el servidor necesitaba para procesar la solicitud |
credits_used | Integer | La cantidad de créditos utilizados para esta consulta |