# Feels-Like Temperature API
> Feels-like (apparent) temperature meteorology as an API, computed locally and deterministically. The wind-chill endpoint computes how cold the air feels when wind carries body heat away, using the Environment Canada formula WC = 13.12 + 0.6215·T − 11.37·V^0.16 + 0.3965·T·V^0.16 from the air temperature (°C) and wind speed (km/h), valid at 10 °C or below with wind of at least 4.8 km/h. The heat-index endpoint computes how hot it feels in warm, humid air with the US National Weather Service Rothfusz regression from temperature and relative humidity, since high humidity slows sweat evaporation, with the low-/high-humidity adjustments. The apparent-temperature endpoint computes the Australian Bureau of Meteorology apparent temperature, AT = Ta + 0.33·e − 0.70·ws − 4.00, which combines the warming effect of humidity (through the vapour pressure e) and the cooling effect of wind (ws in m/s) in a single feels-like value. Temperatures are in °C (Fahrenheit also returned), humidity in %, wind in km/h for wind chill and m/s for apparent temperature. Everything is computed locally and deterministically, so it is instant and private. Ideal for weather, outdoor-activity, sports, smart-home and wearable app developers, comfort and safety tools, and meteorology education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is the feels-like temperature calculator; for the occupational WBGT heat-stress index use a WBGT API and for live weather observations a weather data API.

## 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/feelslike-api/..."
```

## Pricing
- **Free** (Free) — 3,200 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 43,000 calls/Mo, 6 req/s
- **Pro** ($16/Mo) — 255,000 calls/Mo, 15 req/s
- **Mega** ($52/Mo) — 1,480,000 calls/Mo, 40 req/s

## Endpoints

### FeelsLike

#### `GET /v1/apparent-temperature` — Apparent temperature

**Parameters:**
- `temperature` (query, required, string) — Air temperature (°C) Example: `30`
- `humidity` (query, required, string) — Relative humidity (%) Example: `60`
- `wind_speed` (query, optional, string) — Wind speed (m/s) Example: `2`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/feelslike-api/v1/apparent-temperature?temperature=30&humidity=60&wind_speed=2"
```

**Response:**
```json
{
    "data": {
        "note": "Australian BOM apparent temperature: AT = Ta + 0.33·e − 0.70·ws − 4.00, with vapour pressure e (hPa) and wind ws (m/s). Combines humidity (warming) and wind (cooling) in one feels-like value.",
        "inputs": {
            "humidity_pct": 60,
            "temperature_c": 30,
            "wind_speed_ms": 2
        },
        "vapour_pressure_hpa": 25.3723,
        "apparent_temperature_c": 32.97,
        "apparent_temperature_f": 91.35
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:35.570Z",
        "request_id": "5adfb869-6513-4b15-a90e-1a274be82a04"
    },
    "status": "ok",
    "message": "Apparent temperature",
    "success": true
}
```

#### `GET /v1/heat-index` — Heat index

**Parameters:**
- `temperature` (query, required, string) — Air temperature (°C) Example: `32`
- `humidity` (query, required, string) — Relative humidity (%) Example: `70`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/feelslike-api/v1/heat-index?temperature=32&humidity=70"
```

**Response:**
```json
{
    "data": {
        "note": "NWS Rothfusz heat index (apparent temperature in warm, humid air ≥ 27 °C). High humidity slows sweat evaporation, so it feels hotter.",
        "inputs": {
            "humidity_pct": 70,
            "temperature_c": 32
        },
        "applicable": true,
        "heat_index_c": 40.41,
        "heat_index_f": 104.74
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:35.658Z",
        "request_id": "005eee40-4d25-4769-8edb-ba607839af50"
    },
    "status": "ok",
    "message": "Heat index",
    "success": true
}
```

#### `GET /v1/wind-chill` — Wind chill

**Parameters:**
- `temperature` (query, required, string) — Air temperature (°C) Example: `-10`
- `wind_speed` (query, required, string) — Wind speed (km/h) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/feelslike-api/v1/wind-chill?temperature=-10&wind_speed=30"
```

**Response:**
```json
{
    "data": {
        "note": "Environment Canada wind chill: WC = 13.12 + 0.6215T − 11.37V^0.16 + 0.3965T·V^0.16 (T °C, V km/h). Faster wind carries body heat away, so it feels colder than the air temperature.",
        "inputs": {
            "temperature_c": -10,
            "wind_speed_kmh": 30
        },
        "applicable": true,
        "wind_chill_c": -19.52,
        "wind_chill_f": -3.14
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:35.746Z",
        "request_id": "3f848c33-306b-4882-97f9-271f56fe91c5"
    },
    "status": "ok",
    "message": "Wind chill",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/feelslike-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "notes": "Temperature in °C (°F also returned), humidity in %, wind in km/h for wind chill and m/s for apparent temperature. Wind chill applies at ≤10 °C; heat index at ≥27 °C.",
        "service": "feelslike-api",
        "formulae": {
            "wind_chill": "WC = 13.12 + 0.6215T − 11.37V^0.16 + 0.3965T·V^0.16",
            "apparent_temperature": "AT = Ta + 0.33·e − 0.70·ws − 4.00"
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/heat-index": "Heat index from temperature and humidity (hot-weather feels-like).",
            "GET /v1/wind-chill": "Wind chill from air temperature and wind speed (cold-weather feels-like).",
            "GET /v1/apparent-temperature": "BOM apparent temperature from temperature, humidity and wind."
        },
        "description": "Feels-like temperature calculator: wind chill (Environment Canada), heat index (NWS Rothfusz) and the Australian BOM apparent temperature combining humidity and wind."
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:35.834Z",
        "request_id": "337f25dd-518c-470c-8b1f-342c2b233e67"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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