PHPackages                             pixelpeter/laravel5-genderize-api-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. pixelpeter/laravel5-genderize-api-client

Abandoned → [pixelpeter/laravel-genderize-api-client](/?search=pixelpeter%2Flaravel-genderize-api-client)Library[API Development](/categories/api)

pixelpeter/laravel5-genderize-api-client
========================================

Laravel 5 client for the genderize.io API

v2.0.0(8y ago)4666.9k6[2 PRs](https://github.com/pixelpeter/laravel5-genderize-api-client/pulls)MITPHPPHP ^7.0CI passing

Since May 24Pushed 5mo ago3 watchersCompare

[ Source](https://github.com/pixelpeter/laravel5-genderize-api-client)[ Packagist](https://packagist.org/packages/pixelpeter/laravel5-genderize-api-client)[ Docs](https://github.com/pixelpeter/laravel5-genderize-api-client)[ RSS](/packages/pixelpeter-laravel5-genderize-api-client/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (5)Dependencies (5)Versions (7)Used By (0)

Laravel 5 Genderize.io API Client
=================================

[](#laravel-5-genderizeio-api-client)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1a1032a166d2a75731c147dbce3b8fa608681479ecff0e069595173cd5f6280b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f706978656c70657465722f6c61726176656c352d67656e646572697a652d6170692d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pixelpeter/laravel5-genderize-api-client)[![Total Downloads](https://camo.githubusercontent.com/cab9c45daf7040f530e36b32b9156dffc6fc87a2cad317294670130ef2f3e3d4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f706978656c70657465722f6c61726176656c352d67656e646572697a652d6170692d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pixelpeter/laravel5-genderize-api-client)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Coverage Status](https://camo.githubusercontent.com/0a0950f43560724d35aca8eede8fac58e1d6f5711644190e350d3ac6ce3fdaf8/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f706978656c70657465722f6c61726176656c352d67656e646572697a652d6170692d636c69656e742f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/pixelpeter/laravel5-genderize-api-client?branch=master)[![Tests](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/run-tests.yml/badge.svg?branch=master)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/run-tests.yml)[![Fix PHP code style issues](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/fix-php-code-style-issues.yml)[![PHPStan](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/phpstan.yml/badge.svg)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/phpstan.yml)[![dependabot-auto-merge](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/dependabot-auto-merge.yml/badge.svg)](https://github.com/pixelpeter/laravel5-genderize-api-client/actions/workflows/dependabot-auto-merge.yml)

A simple Laravel 5 client for the [Genderize.io API](https://genderize.io/). It provides a fluent interface for easy request building.

WARNING: This library is deprecated. Please use  instead.
---------------------------------------------------------------------------------------------------------------------

[](#warning-this-library-is-deprecated-please-use-httpsgithubcompixelpeterlaravel-genderize-api-client-instead)

Version overview
----------------

[](#version-overview)

Laravelphpuse branch5.87.1, 7.2, 7.3master5.77.1, 7.2, 7.32.0.x5.67.1, 7.2, 7.32.0.x5.57.0, 7.1, 7.21.1.x/2.0.xInstallation
------------

[](#installation)

### Step 1: Install Through Composer

[](#step-1-install-through-composer)

```
composer require pixelpeter/laravel5-genderize-api-client
```

### Step 2: Add the Service Provider (not needed with v2.x because of auto discovery)

[](#step-2-add-the-service-provider-not-needed-with-v2x-because-of-auto-discovery)

Add the service provider in `app/config/app.php`

```
'provider' => [
    ...
    Pixelpeter\Genderize\GenderizeServiceProvider::class,
    ...
];
```

### Step 3: Add the Facade

[](#step-3-add-the-facade)

Add the alias in `app/config/app.php`

```
'aliases' => [
    ...
    'Genderize' => Pixelpeter\Genderize\Facades\Genderize::class,
    ...
];
```

### Step 4: Publish the configuration file

[](#step-4-publish-the-configuration-file)

This is only needed when you have an API key from Genderize.io

```
php artisan vendor:publish --provider="Pixelpeter\Genderize\GenderizeServiceProvider"
```

Examples
--------

[](#examples)

### Send requests

[](#send-requests)

#### Single name

[](#single-name)

```
use Genderize;

Genderize::name('Peter')->get();
```

#### Multiple names (max. 10)

[](#multiple-names-max-10)

```
use Genderize;

Genderize::name(['John', 'Jane'])->get();

// or for better readability you can use the plural
Genderize::names(['John', 'Jane'])->get();
```

#### Add language and country options

[](#add-language-and-country-options)

```
use Genderize;

Genderize::name('John')->country('US')->lang('EN')->get();
```

### Working with the response

[](#working-with-the-response)

#### For single usage

[](#for-single-usage)

```
use Genderize;

$response = Genderize::name('Peter')->get();

print $response->result->first()->gender; // 'male'
print $response->result->first()->name; // 'Peter'
print $response->result->first()->probability; '0.99'
print $response->result->first()->count; 144
print $response->result->first()->isMale(); true
print $response->result->first()->isFemale(); false
print $response->result->first()->isNotMale(); false
print $response->result->first()->isNotFemale(); true
```

#### For batch usage

[](#for-batch-usage)

```
use Genderize;

$response = Genderize::names(['John', 'Jane'])->country('US')->lang('EN')->get();

foreach($response->result as $row)
{
    print $row->name;
}
```

### Getting information about the request and limits

[](#getting-information-about-the-request-and-limits)

```
use Genderize;

$response = Genderize::name('Peter')->get();

print $response->meta->code; // 200 - HTTP response code
print $response->meta->limit; // 1000 - Max number of allowed requests
print $response->meta->remaining; // 950 - Number of requests left
print $response->meta->reset->diffInSeconds(); // Carbon\Carbon - time left till reset
```

### More documentation

[](#more-documentation)

Refer to [Genderize.io API Documentation](https://genderize.io/documentation/) for more examples and documentation.

Testing
-------

[](#testing)

Run the tests with:

```
vendor/bin/phpunit
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

45

↑

FairBetter than 91% of packages

Maintenance48

Moderate activity, may be stable

Popularity40

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 77.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~145 days

Total

5

Last Release

3103d ago

Major Versions

v1.1.0 → v2.0.02017-12-25

PHP version history (2 changes)v1.0PHP &gt;=5.5.9

v2.0.0PHP ^7.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6502630?v=4)[pixelpeter](/maintainers/pixelpeter)[@pixelpeter](https://github.com/pixelpeter)

---

Top Contributors

[![pixelpeter](https://avatars.githubusercontent.com/u/6502630?v=4)](https://github.com/pixelpeter "pixelpeter (42 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![dependabot-support](https://avatars.githubusercontent.com/u/112581971?v=4)](https://github.com/dependabot-support "dependabot-support (3 commits)")[![Stroemgren](https://avatars.githubusercontent.com/u/2242472?v=4)](https://github.com/Stroemgren "Stroemgren (2 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")[![jibar026](https://avatars.githubusercontent.com/u/59713182?v=4)](https://github.com/jibar026 "jibar026 (1 commits)")

---

Tags

api-clientgenderlaravelvalidationapilaravelvalidationgender

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pixelpeter-laravel5-genderize-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/pixelpeter-laravel5-genderize-api-client/health.svg)](https://phpackages.com/packages/pixelpeter-laravel5-genderize-api-client)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
