For Agents
Predict the likely gender of a first name with a confidence score, with optional country and language localisation.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Genderize API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Genderize API API.
Predict the most likely gender for a single first name with /?name={name}
Batch up to 10 names in one call by repeating the name parameter (name[]=)
Localise predictions by ISO 3166-1 country code with the country_id query parameter
Localise predictions by ISO 639-1 language code with the language_id query parameter
GET STARTED
Use for: Predict the likely gender of the name 'Jordan', Get a gender prediction localised to Germany for 'Andrea', Batch predict genders for a list of 10 first names, Look up the confidence score for a first name's gender
Not supported: Does not handle full identity verification, age prediction, or nationality lookup — use for first-name gender prediction only.
The Genderize API predicts the most likely gender associated with a first name, returning a gender label, a probability score between 0 and 1, and the count of source records used to derive the prediction. It supports localisation by ISO country and language code, batch lookups of up to 10 names per request, and a free tier of 100 requests per day. The single endpoint is a pure read; an optional API key in the apikey query parameter unlocks higher quotas.
Read remaining-quota headers from each response to track usage against the 100/day free tier
Patterns agents use Genderize API API for, with concrete tasks.
★ CRM Contact Enrichment
Enrich a CRM contact list with predicted gender and probability so segmentation and personalisation logic can run downstream. The agent batches names 10 at a time against the root endpoint and writes the gender, probability, and count fields back to the contact record. Removes a manual or vendor-paid pre-processing step.
Build a request with name[]=Alice&name[]=Bob (up to 10), GET /, and write each {name, gender, probability} pair back to the CRM record
Localised Gender Predictions For International Audiences
Improve prediction accuracy for international name lists by passing country_id or language_id with each call. The agent groups records by region and issues localised lookups so 'Andrea' resolves correctly in Italy versus the US. Sharpens downstream analytics on multi-region datasets.
GET /?name=Andrea&country_id=IT for the Italian rows and /?name=Andrea&country_id=US for the US rows; merge results back onto the source dataset
Form Validation And Personalisation
When a user signs up with only a first name, predict gender to drive default avatar selection or pronoun fallback while leaving an explicit override option. The agent calls the endpoint at signup and stores the result with its probability so the UI can fall back to a neutral default when confidence is low.
On signup, GET /?name={firstName}; if probability < 0.7, render a neutral avatar and prompt for explicit pronouns
Agent-Driven Enrichment Through Jentic
AI agents discover Genderize via Jentic intent search, load the predict-gender operation, and enrich names inline without writing a custom client. Jentic isolates the API key in its vault for the higher-quota tier. Useful for data-prep agents working over CRM exports.
Use Jentic search query 'predict the gender of a name' to load the genderize_predict_gender tool and execute with the name and optional country_id
1 endpoints — the genderize api predicts the most likely gender associated with a first name, returning a gender label, a probability score between 0 and 1, and the count of source records used to derive the prediction.
METHOD
PATH
DESCRIPTION
/
Predict gender for a single name or a batch with optional localisation
/
Predict gender for a single name or a batch with optional localisation
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Genderize apikey value is stored encrypted in the Jentic vault and appended to the query string at execution time. Agents stay on a scoped execution token and never see the raw key.
Intent-based discovery
Even with a single endpoint, agents benefit from Jentic's intent search: 'predict the gender of a name' resolves to the right operation with its input schema, including the optional country_id and language_id parameters.
Time to first call
Direct Genderize integration: under an hour. Through Jentic: under 5 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Agify API
Agify predicts age from a first name from the same family of single-purpose enrichment APIs.
Use Agify alongside Genderize when a contact-enrichment workflow needs both age and gender estimates from the same name field.
Nationalize API
Nationalize predicts likely nationality from a first name and shares Genderize's interface conventions.
Use Nationalize alongside Genderize for richer demographic enrichment from a name-only input.
Abstract API
Abstract API offers a broader bundle of enrichment endpoints; Genderize stays a single-purpose, low-cost gender prediction.
Choose Abstract API when the same workflow also needs IP geolocation, email validation, or phone validation; choose Genderize for focused gender prediction with a free tier.
Specific to using Genderize API API through Jentic.
What authentication does the Genderize API use?
Genderize is keyless on the free tier (100 requests per day per IP). For higher quotas pass an apikey query parameter on each request. Through Jentic the key is stored encrypted in the vault and appended at execution time.
Can I batch multiple names in one Genderize request?
Yes. The single GET / endpoint accepts up to 10 names per call by repeating the name parameter as name[]=Alice&name[]=Bob. The response is an array of predictions in the same order as the inputs.
How do I localise a prediction by country?
Pass country_id with an ISO 3166-1 alpha-2 code, for example country_id=IT. Genderize will weight its prediction by data from that country, sharpening results for ambiguous cross-cultural names.
What are the rate limits for the Genderize API?
The free tier allows 100 requests per day per IP. Paid plans raise the daily ceiling — Genderize sets X-Rate-Limit headers on each response so clients can track remaining quota in real time.
What does the probability field mean?
Probability is a value between 0 and 1 representing the share of source records that match the predicted gender. Treat values below roughly 0.7 as low-confidence and either store the score or fall back to a neutral default in your UI.
How do I predict gender through Jentic?
Install with pip install jentic, search 'predict the gender of a name', load the schema for the genderize_predict_gender operation, and execute with the name and optional country_id. Jentic appends the API key from the vault.