API Documentation

Complete reference for the GenderMyName API

Quick Start

Get started in 3 simple steps

Sign up and get your API key

Create a free account and generate your API key from the dashboard

Make your first request

Include your API key in the X-API-Key header

curl -X GET "https://gendermyname.com/api/v1/gender/maria" \
  -H "X-API-Key: gm_your_api_key_here"

Get the response

Receive gender classification with confidence score

{
  "success": true,
  "data": {
    "name": "Maria",
    "gender": "F",
    "confidence": 0.9952,
    "male_count": 1234,
    "female_count": 98765
  },
  "meta": {
    "requests_used": 1,
    "requests_remaining": 99,
    "requests_limit": 100,
    "tier": "free"
  }
}

Authentication

All API requests require authentication

Include your API key in the X-API-Key header with every request:

X-API-Key: gm_your_api_key_here

Keep your API key secure!

Never share your API key publicly or commit it to version control. Rotate your keys regularly.

API Endpoints

Available endpoints for gender classification

GET

/api/v1/gender/{name}

Classify the gender of a given name with confidence score

Request

curl -X GET "https://gendermyname.com/api/v1/gender/maria" \
  -H "X-API-Key: gm_your_api_key_here"

Response

{
  "success": true,
  "data": {
    "name": "Maria",
    "gender": "F",
    "confidence": 0.9952,
    "male_count": 1234,
    "female_count": 98765
  },
  "meta": {
    "requests_used": 15,
    "requests_remaining": 235,
    "requests_limit": 250,
    "tier": "standard",
    "reset_at": "2025-02-01T00:00:00.000Z"
  }
}

Response Fields

genderM (male) or F (female)

confidenceConfidence score between 0 and 1

male_countTotal occurrences as male across all countries

female_countTotal occurrences as female across all countries

Supported Countries

Countries available for country-specific gender predictions

Our database includes official government data from 20 countries. Use these country codes with the country-specific endpoint:

ATAustria

AUAustralia

BEBelgium

BRBrazil

CACanada

CHSwitzerland

DKDenmark

ESSpain

FIFinland

FRFrance

GBUnited Kingdom

IEIreland

ILIsrael

ISIceland

ITItaly

NONorway

NZNew Zealand

PLPoland

SESweden

USUnited States

Country-specific predictions

Names can have different gender associations in different countries. For example, "Andrea" is predominantly male in Italy but female in the US. Use the country-specific endpoint for higher accuracy when you know the person's country.

Rate Limits

Request limits by subscription tier

Free Tier

100 requests (lifetime)

Basic Plan

25,000 requests/month

Standard Plan

250,000 requests/month

Plus Plan

2.5M requests/month

Premium Plan

25M requests/month

Rate limits are per account

Usage is tracked per USER/ACCOUNT across all API keys. Multiple API keys share the same rate limit.

Rate limit information is included in response headers:

X-RateLimit-Limit: 250000
X-RateLimit-Remaining: 249987
X-RateLimit-Reset: 2025-02-01T00:00:00.000Z

Error Codes

Common error responses

401

Unauthorized

Invalid or missing API key

429

Too Many Requests

Rate limit exceeded

404

Not Found

Name not found in database

500

Internal Server Error

Server error - please contact support

Code Examples

Integration examples in popular languages

const apiKey = 'gm_your_api_key_here';

async function classifyGender(name) {
  const response = await fetch(
    `https://gendermyname.com/api/v1/gender/${name}`,
    {
      headers: {
        'X-API-Key': apiKey
      }
    }
  );

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const data = await response.json();
  return data;
}

// Usage
classifyGender('maria')
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Need Help?

Get support and stay updated

Support

Need help? Contact us at support@gendermyname.com

Status

Check API status at status.gendermyname.com