---OPENAPI SPEC---
```yaml
openapi: 3.0.3
info:
title: Kruxor Baby Names API
description: >
Access comprehensive historical data on the relative frequency of given names
from U.S. birth records. This API provides insights into naming trends,
popularity rankings, and demographic shifts dating back to 1880.
contact:
email: admin@kruxor.com
version: 1.0.1
x-logo:
url: https://api.kruxor.com/favicon.png

servers:
- url: https://api.kruxor.com
description: Production server

tags:
- name: Data Retrieval
description: Endpoints for fetching baby name records and statistics.
- name: Metadata
description: Endpoints for discovering available database fields and schema info.

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

schemas:
BabyName:
type: object
properties:
id:
type: integer
example: 1024
uid:
type: string
example: "bn_5f3a2b1c"
insdate:
type: string
format: date-time
example: "2023-10-27 14:20:01"
title:
type: string
example: "James"
additional:
type: string
nullable: true
example: "Raw data source: SSA-2022-TX"
category:
type: string
example: "M"
md5:
type: string
example: "e99a18c428cb38d5f260853678922e03"
birth_year:
type: integer
example: 1985
name:
type: string
example: "James"
sex:
type: string
enum: [M, F]
example: "M"
occurrence_count:
type: integer
example: 64120
popularity_rank:
type: integer
example: 1

FieldList:
type: array
items:
type: string
example: ["id", "uid", "birth_year", "name", "sex", "occurrence_count", "popularity_rank"]

security:
- ApiKeyAuth: []

paths:
/api/v1/babynames/list:
get:
tags:
- Data Retrieval
summary: List latest baby names
description: Returns a paginated list of the most recently updated or added baby name records. Limited to 50 results per request.
parameters:
- name: page
in: query
description: Page number for pagination.
schema:
type: integer
default: 1
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:
tags:
- Data Retrieval
summary: Search baby names
description: Search the database using any field (name, birth_year, sex, etc.). Supports exact and fuzzy matching. Limited to 50 results per request.
parameters:
- name: name
in: query
schema:
type: string
example: "Mary"
- name: birth_year
in: query
schema:
type: integer
example: 1920
- name: sex
in: query
schema:
type: string
example: "F"
- name: page
in: query
schema:
type: integer
default: 1
- name: search_type
in: query
description: The type of search to perform.
schema:
type: string
enum: [EXACT, LIKE]
default: EXACT
responses:
'200':
description: Search results.
content:
application:json:
schema:
type: array
items:
$ref: '#/components/schemas/BabyName'

/api/v1/babynames/search_like:
get:
tags:
- Data Retrieval
summary: Fuzzy search (LIKE)
description: Alias for the search endpoint specifically configured for fuzzy matching (using SQL %LIKE% logic).
parameters:
- name: name
in: query
schema:
type: string
example: "Ann"
- name: page
in: query
schema:
type: integer
default: 1
responses:
'200':
description: Fuzzy search results.
content:
application:json:
schema:
type: array
items:
$ref: '#/components/schemas/BabyName'

/api/v1/babynames/prices:
get:
tags:
- Data Retrieval
summary: Search by value metrics
description: An alias for the search endpoint, often used for filtering by high-occurrence or specific rank-based datasets.
parameters:
- name: occurrence_count
in: query
schema:
type: integer
- name: page
in: query
schema:
type: integer
default: 1
responses:
'200':
description: Filtered results.
content:
application:json:
schema:
type: array
items:
$ref: '#/components/schemas/BabyName'

/api/v1/babynames/fields:
get:
tags:
- Metadata
summary: List searchable columns
description: Returns an array of strings representing all database columns that can be used as search parameters.
responses:
'200':
description: List of fields.
content:
application:json:
schema:
$ref: '#/components/schemas/FieldList'
```

---ABOUT DESCRIPTION---

Unlock the power of historical U.S. demographic data with the Kruxor Baby Names API. This robust dataset is derived from official Social Security Administration records, covering the relative frequency of given names for every birth year since 1880. Whether you are building a parenting app, conducting sociological research, or developing a genealogical platform, this API provides the granular data needed to analyze naming trends, popularity shifts, and cultural evolution over the last century.

Our API is designed for high performance and ease of integration. With features like fuzzy search (LIKE), exact matching, and popularity ranking, developers can easily query millions of records to find specific names or discover top-trending names within a specific birth year. Each record includes the name, birth year, gender, total occurrences, and the calculated popularity rank for that period, ensuring you have a complete statistical profile for every entry.

Integrate the Kruxor Baby Names API today to provide your users with deep insights into their heritage or to power modern AI models with historical naming conventions. With structured JSON responses, built-in pagination, and standardized OpenAPI documentation, you can go from integration to deployment in minutes.

---PRICING TIERS---

**FREE TIER**
* **Monthly Request Limit:** 500 Requests
* **Hard Limit:** Yes
* **Price:** $0 / month
* *Ideal for developers testing integration or students working on small personal projects.*

**PRO TIER**
* **Monthly Request Limit:** 50,000 Requests
* **Hard Limit:** No (Overages apply)
* **Price:** $29 / month
* *Designed for production-ready parenting apps and niche research tools requiring consistent data access.*

**MEGA TIER**
* **Monthly Request Limit:** 750,000 Requests
* **Hard Limit:** No (Overages apply)
* **Price:** $149 / month
* *Tailored for enterprise-level platforms, data aggregators, and high-traffic demographic services.*