GenderMyName

API Documentation

Complete reference for the GenderMyName API

Quick Start
Get started in 3 simple steps
1

Sign up and get your API key

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

2

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"
3

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
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