# User-Agent API
> A fast, fully-local User-Agent parser: detect the browser (name and version), rendering engine, operating system (name and a friendly version), device type (desktop, mobile, tablet, TV, wearable or bot), a mobile flag, and bot/crawler identity (Googlebot, Bingbot, social-preview bots, GPTBot/ClaudeBot, curl and more). Bot detection is included on every plan. Pure server-side compute, no third-party upstream, so responses are instant and always available. Ideal for analytics, ad-tech, fraud and bot filtering, personalization and access logs.

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

## Pricing
- **Free** (Free) — 11,000 calls/Mo, 2 req/s
- **Basic** ($7/Mo) — 180,000 calls/Mo, 15 req/s
- **Pro** ($21/Mo) — 1,100,000 calls/Mo, 50 req/s
- **Mega** ($52/Mo) — 5,500,000 calls/Mo, 150 req/s

## Endpoints

### User-Agent

#### `GET /v1/bot` — Bot/crawler detection

**Parameters:**
- `ua` (query, required, string) — User-Agent string Example: `Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/useragent-api/v1/bot?ua=Mozilla%2F5.0+%28compatible%3B+Googlebot%2F2.1%3B+%2Bhttp%3A%2F%2Fwww.google.com%2Fbot.html%29"
```

**Response:**
```json
{
    "data": {
        "is_bot": true,
        "bot_name": "Googlebot",
        "user_agent": "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)",
        "bot_version": "2.1"
    },
    "meta": {
        "timestamp": "2026-05-30T09:00:24.553Z",
        "request_id": "6bda71eb-345a-498d-a57e-c2e943a4169b"
    },
    "status": "ok",
    "message": "Bot check done",
    "success": true
}
```

#### `GET /v1/parse` — Parse a User-Agent

**Parameters:**
- `ua` (query, required, string) — User-Agent string Example: `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/useragent-api/v1/parse?ua=Mozilla%2F5.0+%28Windows+NT+10.0%3B+Win64%3B+x64%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F124.0.0.0+Safari%2F537.36"
```

**Response:**
```json
{
    "data": {
        "os": {
            "name": "Windows",
            "version": "10/11"
        },
        "bot": null,
        "engine": {
            "name": "Blink",
            "version": null
        },
        "is_bot": false,
        "mobile": false,
        "browser": {
            "name": "Chrome",
            "version": "124.0.0.0"
        },
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
        "device_type": "desktop"
    },
    "meta": {
        "timestamp": "2026-05-30T09:00:24.629Z",
        "request_id": "ee74af1c-2126-41c3-900c-45f09c19fac6"
    },
    "status": "ok",
    "message": "User-Agent parsed",
    "success": true
}
```


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