# Name Insights API
> Enrich a first name with predicted gender, age and nationality — with confidence probabilities and an optional country bias for higher accuracy. One combined call returns all three. Ideal for CRM enrichment, personalization, form pre-fill, audience analytics and demographic segmentation.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/nameinsights-api/..."
```

## Pricing
- **Free** (Free) — 1,000 calls/Mo, 5 req/s
- **Basic** ($15/Mo) — 50,000 calls/Mo, 10 req/s
- **Pro** ($49/Mo) — 250,000 calls/Mo, 20 req/s
- **Mega** ($129/Mo) — 1,000,000 calls/Mo, 40 req/s

## Endpoints

### Name Insights

#### `GET /v1/age` — Predict age

**Parameters:**
- `name` (query, required, string) — First name Example: `peter`
- `country_id` (query, optional, string) — 2-letter ISO country bias

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nameinsights-api/v1/age?name=peter"
```

**Response:**
```json
{
    "data": {
        "age": 71,
        "name": "peter",
        "count": 169145,
        "country_id": null
    },
    "meta": {
        "timestamp": "2026-05-30T03:31:45.861Z",
        "request_id": "c56b0e1d-8cae-407f-85d4-8d50c3d9ab36"
    },
    "status": "ok",
    "message": "Age predicted successfully",
    "success": true
}
```

#### `GET /v1/gender` — Predict gender

**Parameters:**
- `name` (query, required, string) — First name Example: `peter`
- `country_id` (query, optional, string) — 2-letter ISO country bias

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nameinsights-api/v1/gender?name=peter"
```

**Response:**
```json
{
    "data": {
        "name": "peter",
        "count": 1346866,
        "gender": "male",
        "country_id": null,
        "probability": 1
    },
    "meta": {
        "timestamp": "2026-05-30T03:31:46.561Z",
        "request_id": "8d53d222-63a2-4ec7-9914-71d00ad1f300"
    },
    "status": "ok",
    "message": "Gender predicted successfully",
    "success": true
}
```

#### `GET /v1/insights` — Gender + age + nationality

**Parameters:**
- `name` (query, required, string) — First name Example: `peter`
- `country_id` (query, optional, string) — 2-letter ISO country bias

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nameinsights-api/v1/insights?name=peter"
```

**Response:**
```json
{
    "data": {
        "age": {
            "count": 169145,
            "value": 71
        },
        "name": "peter",
        "gender": {
            "count": 1346866,
            "value": "male",
            "probability": 1
        },
        "country_id": null,
        "nationality": [
            {
                "country_id": "NG",
                "probability": 0.07808044340500363
            },
            {
                "country_id": "KE",
                "probability": 0.0455265113731697
            },
            {
                "country_id": "UG",
                "probability": 0.042889028691174495
            },
            {
                "country_id": "CN",
                "probability": 0.03778918961958605
            },
            {
                "country_id": "TZ",
                "probability": 0.03515064125148246
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T03:31:47.842Z",
        "request_id": "e3232c08-d2ca-4205-8de9-803d66e0391b"
    },
    "status": "ok",
    "message": "Insights retrieved successfully",
    "success": true
}
```

#### `GET /v1/nationality` — Predict nationality

**Parameters:**
- `name` (query, required, string) — First name Example: `peter`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nameinsights-api/v1/nationality?name=peter"
```

**Response:**
```json
{
    "data": {
        "name": "peter",
        "countries": [
            {
                "country_id": "NG",
                "probability": 0.07808044340500363
            },
            {
                "country_id": "KE",
                "probability": 0.0455265113731697
            },
            {
                "country_id": "UG",
                "probability": 0.042889028691174495
            },
            {
                "country_id": "CN",
                "probability": 0.03778918961958605
            },
            {
                "country_id": "TZ",
                "probability": 0.03515064125148246
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T03:31:48.600Z",
        "request_id": "ebcf79d9-5a4d-415c-a28a-f3eedf1bec2a"
    },
    "status": "ok",
    "message": "Nationality predicted successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/nameinsights-api
OpenAPI spec: https://www.oanor.com/api/nameinsights-api/openapi.json