Agify.io · Schema

AgePrediction

Age prediction result returned by the Agify API for a single name lookup.

Age PredictionName AnalysisDemographicsStatistical APIFree API

Properties

Name Type Description
name string The name as processed by the API. May differ from the input if diacritics were stripped or if first/last name parsing occurred.
age integernull Predicted age in years based on statistical analysis of name distributions. Null when the name is absent from the dataset.
count integer Number of data records supporting the age prediction. Higher values indicate greater statistical confidence.
country_id string ISO 3166-1 alpha-2 country code used to scope the prediction, echoed from the request when provided.
View JSON Schema on GitHub

JSON Schema

age-prediction-response.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/agify/json-schema/age-prediction-response.json",
  "title": "AgePrediction",
  "description": "Age prediction result returned by the Agify API for a single name lookup.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The name as processed by the API. May differ from the input if diacritics were stripped or if first/last name parsing occurred.",
      "examples": ["michael", "anna", "john"]
    },
    "age": {
      "type": ["integer", "null"],
      "description": "Predicted age in years based on statistical analysis of name distributions. Null when the name is absent from the dataset.",
      "minimum": 0,
      "examples": [65, 42, null]
    },
    "count": {
      "type": "integer",
      "description": "Number of data records supporting the age prediction. Higher values indicate greater statistical confidence.",
      "minimum": 0,
      "examples": [298219, 185234, 0]
    },
    "country_id": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code used to scope the prediction, echoed from the request when provided.",
      "pattern": "^[A-Z]{2}$",
      "examples": ["US", "GB", "DE", "EG"]
    }
  },
  "required": ["name", "age", "count"],
  "additionalProperties": false
}