Gender

Which countries a name is recorded in

This is not a "country of origin" lookup, and it is deliberately not named like one: the data cannot support that claim, and the difference is measurable.

Counted name statistics exist for eleven countries only: birth registrations in the US, UK, France, Canada, Spain, Ireland, Norway, Austria and Israel, and living-resident counts in Poland and Switzerland. Everything else is presence data — it says a name occurs in a country, not how many people carry it. So a query for Mehmet ranks Switzerland and France first, at about 29% each, and Turkey does not appear in the ranking at all, because Turkey publishes no counts.

The response therefore keeps the two apart. registrations is measured volume and is comparable, but only among the counting countries. attested_in is presence, and that is where Turkey, Japan and India show up. Neither field is a claim about any person's origin or ethnicity.

Credits. One credit per request. ai_fallback and best_guess do not apply here and are ignored.

post/api/v1/gender/countries

Request

  • Base URL: https://namegender.com
  • URL: https://namegender.com/api/v1/gender/countries
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Request body

namestring required

The first name to look up.

limitinteger

How many counted countries to list in registrations. Shares and basis.counted_countries are not affected, and attested_in is never cut.

Example request

{
  "name": "Mehmet"
}

Response

Country distribution, with the basis of the numbers stated in the response itself.

credits_chargedinteger

How many credits this call took from the balance: always 1.

credits_remaininginteger

Balance once this call is paid for.

data_versionstring nullable

Name-dataset snapshot that produced the answer.

request_idstring nullable

Identifier of this call, also sent as the X-Request-Id header. Quote it in support requests.

took_msinteger

Whole milliseconds spent building the distribution on our side, network time excluded.

namestring

The name that was looked up.

attested_instring[]

Every country the name occurs in, counted or not, alphabetically.

Example response

{
  "took_ms": 3
}

Changes

No recorded changes to this operation across all 1 revision of this API.