---OPENAPI SPEC---
```yaml
openapi: 3.0.0
info:
title: Kruxor Baby Names API
description: Access comprehensive historical data on U.S. baby names, including popularity ranks and occurrence counts dating back to 1880.
version: 1.0.0
servers:
- url: https://api.kruxor.com
description: Production server

components:
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: X-API-KEY
ApiKeyQuery:
type: apiKey
in: query
name: key

schemas:
BabyName:
type: object
properties:
id:
type: integer
example: 1
uid:
type: string
example: "550e8400-e29b-41d4-a716-446655440000"
insdate:
type: string
format: date-time
example: "2023-10-27 10:00:00"
title:
type: string
example: "Mary"
additional:
type: string
nullable: true
category:
type: string
example: "F"
md5:
type: string
example: "e99a18c428cb38d5f260853678922e03"
birth_year:
type: integer
example: 1880
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

PaginatedResponse:
type: object
properties:
status:
type: string
example: "success"
page:
type: integer
example: 1
limit:
type: integer
example: 50
results:
type: array
items:
$ref: '#/components/schemas/BabyName'

security:
- ApiKeyHeader: []
- ApiKeyQuery: []

paths:
/api/v1/babynames/list:
get:
summary: List latest baby names
description: Returns the latest baby name records with a hard limit of 50 results per page.
parameters:
- name: page
in: query
schema:
type: integer
default: 1
description: Page number for pagination.
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse'

/api/v1/babynames/search:
get:
summary: Search baby names
description: Search records by name, birth_year, or sex using exact or fuzzy matching.
parameters:
- name: page
in: query
schema:
type: integer
default: 1
- name: search_type
in: query
schema:
type: string
enum: [exact, like]
default: exact
- name: name
in: query
schema:
type: string
- name: birth_year
in: query
schema:
type: integer
- name: sex
in: query
schema:
type: string
enum: [F, M]
responses:
'200':
description: Search results
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse'

/api/v1/babynames/search_like:
get:
summary: Fuzzy search baby names
description: Alias for the search endpoint with forced %LIKE% matching.
parameters:
- name: page
in: query
schema:
type: integer
default: 1
- name: name
in: query
schema:
type: string
responses:
'200':
description: Fuzzy search results
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse'

/api/v1/babynames/prices:
get:
summary: Pricing-specific model search
description: Alias for search, optimized for high-value data modeling and trend analysis.
parameters:
- name: page
in: query
schema:
type: integer
default: 1
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse'

/api/v1/babynames/fields:
get:
summary: Get searchable fields
description: Returns a list of all searchable database columns for the baby names model.
responses:
'200':
description: List of fields
content:
application/json:
schema:
type: object
properties:
fields:
type: array
items:
type: string
example: ["id", "birth_year", "name", "sex", "occurrence_count", "popularity_rank"]
```

---ABOUT DESCRIPTION---

**Unlock over a century of American naming trends with the Kruxor Baby Names API.** This powerful endpoint provides programmatic access to the official National Data on the frequency of given names from U.S. Social Security records. Spanning from 1880 to the present, the dataset includes millions of records detailing name occurrences, gender distributions, and annual popularity rankings.

Whether you are building a modern baby-naming app, conducting sociological research on cultural shifts, or developing historical fiction that requires period-accurate nomenclature, this API offers the precision you need. With built-in support for fuzzy logic (LIKE) searches and exact filtering by birth year and sex, you can effortlessly identify the rise and fall of names through the decades.

Our API is designed for high-performance integration, featuring standardized JSON outputs, automated pagination, and consistent indexing. Stop manually scraping government PDFs and start utilizing a clean, developer-friendly interface to power your next data-driven project.

---PRICING TIERS---

**FREE TIER**
* **Monthly Request Limit:** 500 Requests
* **Hard Limit:** Yes
* **Monthly Price:** $0.00
* *Ideal for students, hobbyists, and developers testing the initial integration.*

**PRO TIER**
* **Monthly Request Limit:** 25,000 Requests
* **Hard Limit:** No (Overage: $0.002 per request)
* **Monthly Price:** $29.00
* *Designed for growing naming apps and content creators who need consistent historical data access.*

**MEGA TIER**
* **Monthly Request Limit:** Unlimited (Fair Use: 250,000 Requests)
* **Hard Limit:** No
* **Monthly Price:** $89.00
* *Enterprise-grade access for heavy data mining, academic research, and high-traffic commercial applications.*