Genderize.io API
Overview
Genderize.io predicts the likely gender of a given first name using a statistical model trained on a database of over 100 million names from around the world. It returns the predicted gender along with a probability score and the count of name samples used — giving you a confidence measure for each prediction. The API is free for up to 1,000 names per day without authentication.
Beginner Tip
This is one of the simplest APIs you can call — just pass a name in the URL query string and get back a JSON object. No API key required for the free tier. You can also pass a country_id parameter (ISO 3166-1 alpha-2) to get region-specific predictions, since the same name can lean differently by country.
Measurement Record
What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.
- Request
- GET https://api.genderize.io?name=alice
- Result
- HTTP 200 · application/json · 68 bytes · compressed
- Response time
- 323 ms (median of 3) · fastest 313 ms
- Transport
- TLSv1.2 · ECDHE-RSA-AES128-GCM-SHA256 · certificate issued by Let's Encrypt
- Browser CORS
- Allowed — Access-Control-Allow-Origin: *
- Rate limit
- 25 per window
- Served by
- nginx/1.16.1
- Recorded
- 2026-08-10
Fields Returned
Top-level fields present in the response we captured, with the type and value we actually received.
| Field | Type | Value received |
|---|---|---|
| count | integer | 399418 |
| name | string | alice |
| gender | string | female |
| probability | number | 0.99 |
Captured Response
Captured from a real request to https://api.genderize.io?name=alice on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.
{
"count": 399418,
"name": "alice",
"gender": "female",
"probability": 0.99
} Field Reference
name The input first name as provided in the query, returned as-is. gender Predicted gender: "male", "female", or null if the name is not in the database. probability Confidence score from 0.0 to 1.0 — higher means stronger evidence for the predicted gender. count Number of data samples for this name in the Genderize.io database — larger counts mean more reliable predictions. Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://api.genderize.io?name=alice";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
How This API Fails
We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.
Returned an HTML error page rather than JSON — worth knowing if your client assumes every response can be parsed as JSON.
Common Errors & Troubleshooting
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Measured Score Breakdown
Live HTTP request to the API endpoint
Fully tested on Aug 10, 2026
Technical Specifications
Related Tags
Similar APIs
View All →24 Pull Requests
⭐ Beginner's Pick24 Pull Requests is a community initiative that runs every December to encourage developers to contribute to open source projects.
Agify.io
⭐ Beginner's PickAgify.io is a free API that predicts the likely age of a person based solely on their first name, using a database of over 350 million historical records.
API Grátis
API Grátis is a Brazilian API aggregator that bundles multiple free utility services including CEP (postal code) lookup, CNPJ (company registry) data, vehicle plate information, and more — all under a single authentication token.
ApicAgent
⭐ Beginner's PickApicAgent parses User-Agent strings into structured device and browser information, returning details like browser name, version, OS, device type, and whether the client is a bot.
APIs.guru
⭐ Beginner's PickAPIs.guru maintains a crowd-sourced directory of OpenAPI (Swagger) specification files for hundreds of public web APIs, all normalized to OpenAPI 3.0 format.