genderize

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.

📦 Installation

npm install @sebbo2002/genderize

⚡️ Quick Start

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.limit;
Copy

📑 API-Reference

Every hot detail about the API can be found in the documentation.

🚦 Tests

npm test
npm run coverage
Copy

🙆🏼‍♂️ Copyright and license

Copyright (c) Sebastian Pekarek under the MIT license.