Zovo Baby Names

Use this when the user asks how popular a baby name is or was, its rank or number of babies in a year, its trend, peak year, or wants to compare up to 5 names (e.g. "how popular is Olivia", "Emma vs Ava since 1990", "what rank was Jennifer in 1975"). Returns US Social Security birth counts per year 1880-2025, SSA ranks (top 1,000 for past years; listed names in 2025), peak year, highest rank, 10-year change, girls/boys split and other spellings, with a chart. US data only. Does not give name meanings or origins.

{
  "type": "object",
  "properties": {
    "names": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40
      },
      "description": "1 to 5 first names to look up or compare, e.g. [\"Olivia\", \"Charlotte\"]. Add (girl) or (boy) to pick a sex per name, e.g. \"Avery (boy)\". Accents are ignored for lookup (Zoë finds Zoe)."
    },
    "sex": {
      "description": "Sex for all names, e.g. girl. Default any: each name uses the sex with more US births in 2016-2025.",
      "type": "string",
      "maxLength": 30,
      "enum": [
        "girl",
        "boy",
        "any"
      ]
    },
    "year": {
      "description": "Optional single year to report births and rank for, e.g. 1990.",
      "type": "integer",
      "minimum": 1880,
      "maximum": 2025
    }
  },
  "required": [
    "names"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "data_years": {
      "type": "string"
    },
    "decades": {
      "type": "string"
    },
    "names": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "not_found": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "similar": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "reason",
          "similar"
        ],
        "additionalProperties": false
      }
    },
    "source": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "kind",
    "data_years",
    "decades",
    "names",
    "not_found",
    "source",
    "note"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use this when the user wants baby name ideas or lists filtered by sex, first letter, ending, letters contained, length, syllables, 2025 popularity (e.g. "familiar but not common" = rank 201-1000), rising names, vintage names (popular 1910-1930, rare now), names popular in an era, or unisex names (40-60% girls). Returns matching names with 2025 rank, births and trend from US Social Security data. Does not give meanings, origins, religious or astrological criteria; do not use for non-US popularity.

{
  "type": "object",
  "properties": {
    "sex": {
      "description": "girl, boy or any (default any: girls and boys listed separately), e.g. girl.",
      "type": "string",
      "maxLength": 30,
      "enum": [
        "girl",
        "boy",
        "any"
      ]
    },
    "starts_with": {
      "description": "Name begins with these letters, case-insensitive, e.g. \"a\" or \"el\".",
      "type": "string",
      "maxLength": 10
    },
    "ends_with": {
      "description": "Name ends with these letters, e.g. \"lyn\".",
      "type": "string",
      "maxLength": 10
    },
    "contains": {
      "description": "Name contains these letters anywhere, e.g. \"rose\".",
      "type": "string",
      "maxLength": 10
    },
    "min_length": {
      "description": "Minimum letters, e.g. 3.",
      "type": "integer",
      "minimum": 1,
      "maximum": 15
    },
    "max_length": {
      "description": "Maximum letters, e.g. 6.",
      "type": "integer",
      "minimum": 1,
      "maximum": 15
    },
    "min_syllables": {
      "description": "Minimum syllables (approximate), e.g. 2.",
      "type": "integer",
      "minimum": 1,
      "maximum": 6
    },
    "max_syllables": {
      "description": "Maximum syllables (approximate), e.g. 2.",
      "type": "integer",
      "minimum": 1,
      "maximum": 6
    },
    "popularity": {
      "description": "2025 rank band: top_100 (1-100), common (101-200), familiar (201-1000, familiar but not common), uncommon (1001-5000), rare (5001 or lower). Example: familiar.",
      "type": "string",
      "maxLength": 30,
      "enum": [
        "top_100",
        "common",
        "familiar",
        "uncommon",
        "rare"
      ]
    },
    "rank_min": {
      "description": "Lowest 2025 rank number to include, e.g. 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20000
    },
    "rank_max": {
      "description": "Highest 2025 rank number to include, e.g. 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20000
    },
    "rising_years": {
      "description": "Only names with more births in 2025 than N years earlier, sorted by growth, e.g. 10 (compares 2015 to 2025).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "min_births_2025": {
      "description": "Minimum US births in 2025, e.g. 100. Default 50 when rising_years is set, else 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "vintage": {
      "description": "true = vintage names: top 300 in some year 1910-1930 and outside the 2025 top 1,000. Example: true.",
      "type": "boolean"
    },
    "era_from": {
      "description": "Era start year for 'popular back then', e.g. 1950.",
      "type": "integer",
      "minimum": 1880,
      "maximum": 2025
    },
    "era_to": {
      "description": "Era end year, e.g. 1959.",
      "type": "integer",
      "minimum": 1880,
      "maximum": 2025
    },
    "era_max_rank": {
      "description": "Rank a name must have reached in some era year, e.g. 100. Default 300.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "unisex": {
      "description": "true = names where girls are 40-60% of 2016-2025 US births (at least 100 births in that period). Example: true.",
      "type": "boolean"
    },
    "sort": {
      "description": "Order: popular (most 2025 births), rising (biggest growth), alphabetical, rarest (fewest 2025 births). Default popular, or rising with rising_years.",
      "type": "string",
      "maxLength": 30,
      "enum": [
        "popular",
        "rising",
        "alphabetical",
        "rarest"
      ]
    },
    "limit": {
      "description": "How many names to return, 1-60, e.g. 30 (default).",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sort": {
      "type": "string"
    },
    "total_matches": {
      "type": "number"
    },
    "change_since": {
      "type": "number"
    },
    "names": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "note": {
      "type": "string"
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "kind",
    "filters",
    "sort",
    "total_matches",
    "change_since",
    "names",
    "note",
    "source"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}