Lodol Docs

Gender API

API actions for the Gender API integration.

Gender API

Predict gender for names using Gender API.


Predict gender by full name

Predict the gender associated with a full name (first and last name combined).

Parameters

ParameterTypeRequiredDescription
full_namestringYesFull name to analyze

Response

{
  "credits_used": 1,
  "duration": "38ms",
  "first_name": "Sandra",
  "gender": "female",
  "last_name": "Miller",
  "probability": 0.95,
  "raw_response": {
    "details": {
      "country": null,
      "credits_used": 1,
      "duration": "38ms",
      "first_name_sanitized": "sandra",
      "samples": 8765
    },
    "first_name": "Sandra",
    "gender": "female",
    "input": {
      "full_name": "Sandra Miller"
    },
    "last_name": "Miller",
    "probability": 0.95,
    "result_found": true
  },
  "result_found": true,
  "samples": 8765
}

Predict gender by name

Predict the gender associated with a first name, optionally scoped to a country.

Parameters

ParameterTypeRequiredDescription
namestringYesFirst name to analyze
countrystringNoISO 3166-1 alpha-2 country code to localize the prediction

Response

{
  "credits_used": 1,
  "duration": "42ms",
  "first_name": "John",
  "gender": "male",
  "probability": 0.98,
  "raw_response": {
    "details": {
      "country": null,
      "credits_used": 1,
      "duration": "42ms",
      "first_name_sanitized": "john",
      "samples": 12345
    },
    "first_name": "John",
    "gender": "male",
    "input": {
      "first_name": "John"
    },
    "probability": 0.98,
    "result_found": true
  },
  "result_found": true,
  "samples": 12345
}

On this page