genderize
is a simple client for genderize.io, a gender prediction API using a person's name. The library supports both normal and batch usage, allows free and paid usage via an optional API key, and makes it very easy to access rate limiting information. It's written in TypeScript.
npm install @sebbo2002/genderize
importGenderizefrom'@sebbo2002/genderize';constgenderize=newGenderize('API-KEY');// or just `new Genderize()` for free usage// { name: 'Mia', gender: 'female', probability: 0.96, count: 19266 }awaitgenderize.predict('Mia');// {name: 'Steven', gender: 'male, probability: 0.98, count: 5207, country_id: 'US' }awaitgenderize.predict('Alex','US');// [// { name: 'Noah', gender: 'male', probability: 0.88, count: 3939 },// { name: 'Evelyn', gender: 'female', probability: 0.98, count: 12188 }// ]awaitgenderize.predict(['Noah','Evelyn']);// { limit: 1000, remaining: 978, reset: 2022-05-23T00:00:02.203Z }genderize.limit;
Every hot detail about the API can be found in the documentation.
npm test npm run coverage
Copyright (c) Sebastian Pekarek under the MIT license.