SimplyTranslate AI

https://simplytranslate.ai/api-docs
Admin
SimplyTranslate AI is a free RESTful translation API supporting 196+ languages with no API key...
Tokens:1,464
Snippets:15
Trust Score:3.1
Update:5 months ago
Show doc for...
Tokens:
Raw
### Quick Start Translation Request

Source: https://simplytranslate.ai/api-docs

A basic cURL command to perform a translation. No API key is required for this anonymous usage.

```bash
curl -X POST https://api.simplytranslate.ai/translate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, world!",
    "from": "en",
    "to": "zh-cn"
  }'
```

--------------------------------

### cURL Translation Request Example

Source: https://simplytranslate.ai/api-docs

Demonstrates a basic translation request using cURL, specifying the text, source language, and target language in the JSON payload.

```bash
# Basic translation
curl -X POST https://api.simplytranslate.ai/translate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, world!",
    "from": "en",
    "to": "zh-cn"
  }'
```

--------------------------------

### Translate Text with API Key

Source: https://simplytranslate.ai/api-docs

Use this snippet to translate text using the API with an provided API key. Ensure the 'Content-Type' and 'X-API-Key' headers are correctly set.

```bash
curl -X POST https://api.simplytranslate.ai/translate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "text": "Hello, world!",
    "from": "en",
    "to": "ja"
  }'
```

--------------------------------

### Translate Text with JavaScript (Fetch)

Source: https://simplytranslate.ai/api-docs

Asynchronously translates text using the Fetch API. Handles JSON parsing and includes basic error handling.

```javascript
const translateText = async (text, from, to) => {
  const response = await fetch('https://api.simplytranslate.ai/translate', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      text: text,
      from: from,
      to: to
    })
  });
  
  const result = await response.json();
  return result;
};

// Usage
translateText('Hello, world!', 'en', 'zh-cn')
  .then(result => console.log(result.result))
  .catch(error => console.error('Error:', error));
```

--------------------------------

### Translate Text with Python (requests)

Source: https://simplytranslate.ai/api-docs

Translates text using the requests library. It sends a POST request with JSON payload and returns the parsed JSON response.

```python
import requests
import json

def translate_text(text, from_lang, to_lang):
    url = "https://api.simplytranslate.ai/translate"
    
    payload = {
        "text": text,
        "from": from_lang,
        "to": to_lang
    }
    
    response = requests.post(
        url,
        headers={"Content-Type": "application/json"},
        data=json.dumps(payload)
    )
    
    return response.json()

# Usage
result = translate_text("Hello, world!", "en", "zh-cn")
print(result["result"])  # Output: Hello, world!
```

--------------------------------

### Translate Text

Source: https://simplytranslate.ai/api-docs

Translate text from a source language to a target language. Supports anonymous usage or API key authentication.

```APIDOC
## POST /translate

### Description
Translate text from one language to another with high accuracy and speed.

### Method
POST

### Endpoint
`/translate`

### Parameters
#### Request Body
- **text** (string) - Required - Text to translate (max 5,000 characters)
- **from** (string) - Required - Source language code (e.g., "en", "auto")
- **to** (string) - Required - Target language code (e.g., "zh-cn", "ja")
- **token** (string) - Optional - Cloudflare Turnstile verification token

### Request Example
```json
{
  "text": "Hello, world!",
  "from": "en",
  "to": "zh-cn"
}
```

### Response
#### Success Response (200 OK)
- **result** (string) - Translated text
- **from** (string) - Source language detected/used
- **to** (string) - Target language used
- **confidence** (number) - Translation confidence score
- **timestamp** (string) - Timestamp of the translation

#### Response Example
```json
{
  "result": "Translated text",
  "from": "Source language detected/used",
  "to": "Target language used",
  "confidence": 0.98,
  "timestamp": "2024-12-19T10:30:00Z"
}
```

#### Error Response
```json
{
  "error": "Error description",
  "code": "ERROR_CODE",
  "details": "Additional error information"
}
```
```
Tokens:
Raw