Gender API

Keep your registration forms simple. Optimize your conversions and let us determine the gender of your customers.

Sign Up Free

https://gender-api.com/get?name=elizabeth&key=yourkey

{"name":"elizabeth", "gender":"female", "samples":355, "accuracy":100, "duration":"34ms"}

Total Names

1 877 786

Supported Countries

178

Availability

99,9%

TAKE A TEST DRIVE

Go!

RESULT

%name% is %gender%.

JSON OUTPUT

IN DETAIL

name In the json response you will find the submitted name.
gender This is the gender we determined. Possible values are: male, female or unknown.
accuracy This percentage value shows, how certain we are that the determined gender is correct. You can improve the quality of the result by passing a country code to us so that we can better consider local distinctions.
samples This number shows, how many samples of this name we used for the determination.
duration Our API uses several caching techniques to provide you with the requested result as fast as possible. This number shows, how long it took the server to process the request.

WE CAN ALSO DETERMINE THE GENDER OF AN EMAIL ADDRESS

EASY INTEGRATION

Our API can easily be integrated in every existing platform in any language. Take a look at some coding examples.

PHP with composer PHP legacy Python Java jQuery

PHP with composer

Command line

$ composer require gender-api/client


<?php

use GenderApi\Client as GenderApiClient;


try {

$apiClient = new GenderApiClient('insert your API key');

$name = $apiClient->getByFirstName('elisabeth');


if ($name->genderFound()) {

echo $name->getGender(); // will return "female" (possible values: male, female, unknown)

}


} catch (GenderApi\Exception $e) {

// Name lookup failed due to a network error or insufficient requests left

// See https://gender-api.com/en/api-docs/error-codes

echo 'Exception: ' . $e->getMessage();

}

See full client documentation here:

https://github.com/markus-perl/gender-api-client

PHP

<?php


function getGender($firstname) {

$myKey = 'insert your server key here';

$data = json_decode(file_get_contents('https://gender-api.com/get?key=' . $myKey . '&name=' . urlencode($firstname)));

return $data->gender;

}


echo getGender('markus'); //Output: male

Java

import java.io.BufferedReader;

import java.io.IOException;

import java.io.InputStreamReader;

import java.net.HttpURLConnection;

import java.net.URL;

import com.google.gson.Gson;

import com.google.gson.JsonObject;


public class Main {


  public static void main(String[] args) {


  try {

    String myKey = "insert your server key here";

    URL url = new URL("https://gender-api.com/get?key=" + myKey + "&name=markus");

    HttpURLConnection conn = (HttpURLConnection) url.openConnection();


    if (conn.getResponseCode() != 200) {

      throw new RuntimeException("Error: " + conn.getResponseCode());

    }


    InputStreamReader input = new InputStreamReader(conn.getInputStream());

    BufferedReader reader = new BufferedReader(input);


    Gson gson = new Gson();

    JsonObject json = gson.fromJson(reader, JsonObject.class);

    String gender = json.get("gender").getAsString();

    System.out.println("Gender: " + gender); // Gender: male

    conn.disconnect();


    } catch (IOException e) {

      e.printStackTrace();

    }

  }

}

Python 3.*

import json

from urllib.request import urlopen


myKey = "insert your server key here"

url = "https://gender-api.com/get?key=" + myKey + "&name=kevin"

response = urlopen(url)

decoded = response.read().decode('utf-8')

data = json.loads(decoded)

print( "Gender: " + data["gender"]); #Gender: male

 

Python 2.*

import json

import urllib2


myKey = "insert your servery key here"

data = json.load(urllib2.urlopen("https://gender-api.com/get?key=" + myKey + "&name=markus"))

print "Gender: " + data["gender"]; #Gender: male

jQuery

// This example makes use of our jQuery Plugin. Click here for more infos.

//add this code to your HTML within the <head> tag

<script type="text/javascript" src="https://gender-api.com/js/jquery/gender.min.js"></script>

//Javascript Code

$('input#firstname').genderApi({key: genderApiClientKey}).on('gender-found', function(e, result) {

  if (result.accuracy >= 60) {

    alert('Gender found: ' + result.gender);

  }

});

CSV AND EXCEL FILE UPLOAD

Upload CSV files with up to 10,000,000 datasets or Excel files with up to 100,000 datasets per file.

CSV IN
firstname;lastname
Silvia;Miller
Jonathan;Holmes
Sophia;Smith
CSV file will be processed
CSV OUT
firstname;lastname;ga_gender;ga_accuracy
Silvia;Miller;female;99
Jonathan;Holmes;male;100
Sophia;Smith;female;98

OUR UNIQUE FEATURES

1 For a better gender determination we can consider your customer's ip address.
2 Our jQuery plugin provides an easy way of integration.
3 With our CSV bulk upload feature you can query a huge dataset with one single file.
4 We can determine the first name and the gender of an email address such as sandra314@gmail.com.

PRICING

Our cloud-based infrastructure provides an availability of 99.9% and scales with your business.

Subscriptions
One-Time-Payments
500 requests FREE FOR REGISTERED USERS
5 000 requests 7.99 € + VAT per month
25 000 requests 35 € + VAT per month
100 000 requests premium 79 € + VAT per month
500 000 requests 199 € + VAT per month
need a bigger package? Request a quote
Subscriptions can be changed or canceled at any time.
5 000 requests 9.99 € + VAT
25 000 requests 45 € + VAT
100 000 requests premium 99 € + VAT
500 000 requests 299 € + VAT
need a bigger package? Request a quote
No monthly payments. You can charge your account at any time with the needed amount of requests.
Requests need to be used within one year.

Sign Up Free

We use cookies to ensure that we give you the best experience on our website. If you continue to use this site we will assume that you are happy with it.
Got it