# Translation API
> Translate text between 40+ languages with a confidence score and alternative suggestions. Simple GET interface, no model hosting — ideal for localising content, chat messages, product data and user-generated text.

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

## Pricing
- **Free** (Free) — 2,500 calls/Mo, 2 req/s
- **Basic** ($11/Mo) — 40,000 calls/Mo, 8 req/s
- **Pro** ($39/Mo) — 200,000 calls/Mo, 25 req/s
- **Mega** ($109/Mo) — 750,000 calls/Mo, 60 req/s

## Endpoints

### Translation

#### `GET /v1/languages` — Supported languages

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

**Response:**
```json
{
    "data": {
        "count": 42,
        "languages": [
            {
                "code": "en",
                "name": "English"
            },
            {
                "code": "de",
                "name": "German"
            },
            {
                "code": "fr",
                "name": "French"
            },
            {
                "code": "es",
                "name": "Spanish"
            },
            {
                "code": "it",
                "name": "Italian"
            },
            {
                "code": "nl",
                "name": "Dutch"
            },
            {
                "code": "pt",
                "name": "Portuguese"
            },
            {
                "code": "ru",
                "name": "Russian"
            },
            {
                "code": "pl",
                "name": "Polish"
            },
            {
                "code": "uk",
                "name": "Ukrainian"
            },
            {
                "code": "cs",
                "name": "Czech"
            },
            {
                "code": "sk",
                "name": "Slovak"
            },
            {
                "code": "sv",
                "name": "Swedish"
            },
            {
                "code": "no",
                "name": "Norwegian"
            },
            {
                "code": "da",
                "name": "Danish"
            },
            {
                "code": "fi",
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/translate` — Translate text

**Parameters:**
- `text` (query, required, string) — Text to translate Example: `Good morning`
- `to` (query, required, string) — Target language (2-letter) Example: `de`
- `from` (query, optional, string) — Source language (default en) Example: `en`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/translate-api/v1/translate?text=Good+morning&to=de&from=en"
```

**Response:**
```json
{
    "data": {
        "to": "de",
        "from": "en",
        "text": "Good morning",
        "match": 1,
        "translated": "Guten Morgen!",
        "alternatives": [
            {
                "match": 0.99,
                "quality": 74,
                "translation": "Guten Morgen"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T00:53:19.430Z",
        "request_id": "ff1cb69d-9a90-426a-85ec-2ae533175c64"
    },
    "status": "ok",
    "message": "Text translated successfully",
    "success": true
}
```


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