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
import Genderize from '@sebbo2002/genderize';
const genderize = new Genderize('API-KEY'); // or just `new Genderize()` for free usage
// { name: 'Mia', gender: 'female', probability: 0.96, count: 19266 }
await genderize.predict('Mia');
// {name: 'Steven', gender: 'male, probability: 0.98, count: 5207, country_id: 'US' }
await genderize.predict('Alex', 'US');
// [
// { name: 'Noah', gender: 'male', probability: 0.88, count: 3939 },
// { name: 'Evelyn', gender: 'female', probability: 0.98, count: 12188 }
// ]
await genderize.predict(['Noah', 'Evelyn']);
// { limit: 1000, remaining: 978, reset: 2022-05-23T00:00:02.203Z }
genderize.limitEvery hot detail about the API can be found in the documentation.
npm test
npm run coverage
Copyright (c) Sebastian Pekarek under the MIT license.