---OPENAPI SPEC---
```yaml
openapi: 3.0.0
info:
title: Kruxor Baby Names API
description: National data on the relative frequency of given names in the U.S. population, derived from Social Security Administration records dating back to 1880.
version: 1.0.0
servers:
- url: https://api.kruxor.com
description: Production server

components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-KEY

schemas:
BabyName:
type: object
properties:
id:
type: integer
description: Internal unique identifier.
uid:
type: string
description: Unique string identifier.
insdate:
type: string
format: date-time
description: Record insertion date.
title:
type: string
description: Name label (mapping to baby's name).
additional:
type: string
description: Raw line data or debug info.
category:
type: string
description: Data category (often mapped to sex or year).
md5:
type: string
description: Unique row hash (name+year+sex).
birth_year:
type: integer
example: 1990
name:
type: string
example: "Mary"
sex:
type: string
enum: [F, M]
example: "F"
occurrence_count:
type: integer
example: 7065
popularity_rank:
type: integer
example: 1

security:
- ApiKeyAuth: []

paths:
/api/v1/babynames/list:
get:
summary: List latest baby names
description: Returns a list of the most recently added or updated baby name records.
parameters:
- name: max
in: query
description: Maximum number of records to return.
schema:
type: integer
default: 10
- name: start
in: query
description: The offset to start from (for pagination).
schema:
type: integer
default: 0
responses:
'200':
description: A list of baby name records.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BabyName'

/api/v1/babynames/search:
get:
summary: Search baby name records
description: Search the database using any field defined in the data model.
parameters:
- name: max
in: query
description: Maximum number of records to return.
schema:
type: integer
default: 10
- name: name
in: query
schema:
type: string
- name: birth_year
in: query
schema:
type: integer
- name: sex
in: query
schema:
type: string
- name: occurrence_count
in: query
schema:
type: integer
- name: popularity_rank
in: query
schema:
type: integer
- name: category
in: query
schema:
type: string
responses:
'200':
description: Search results.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BabyName'
```

---ABOUT DESCRIPTION---
Unlock over a century of American cultural history with the Kruxor Baby Names API. This robust dataset provides comprehensive national data on the relative frequency of given names from U.S. birth records. Whether you are building a parenting app, conducting sociological research, or developing genealogy tools, our API provides the granular data needed to track naming trends, popularity shifts, and historical naming conventions dating back to 1880.

The Kruxor Baby Names API goes beyond simple lists. By exposing fields such as occurrence counts and calculated popularity ranks per year and gender, developers can build dynamic visualizations, trend predictors, and deep-dive search engines. Each record is indexed with high-performance search capabilities, allowing you to filter by specific years, genders, or exact name matches to deliver instant insights to your end-users.

---PRICING TIERS---

**FREE TIER**
* **Monthly Request Limit:** 500 Requests
* **Hard Limit:** Yes
* **Monthly Price:** $0.00
* *Best for: Initial development, testing integration, and small hobbyist projects.*

**PRO TIER**
* **Monthly Request Limit:** 50,000 Requests
* **Hard Limit:** No (Overages apply)
* **Monthly Price:** $29.00
* *Best for: Growing parenting websites, mobile applications, and academic researchers requiring significant data exports.*

**MEGA TIER**
* **Monthly Request Limit:** Unlimited (Fair Use applies up to 1M)
* **Hard Limit:** No
* **Monthly Price:** $99.00
* *Best for: High-traffic commercial naming platforms, enterprise-level demographic analytics, and AI training models.*