API Documentation

Getting Started

The TranslateAPI provides a simple REST interface for translating text between 200+ languages. All API endpoints return JSON responses.

Quick Start

Make your first translation request:

• cURL
• Python
• JavaScript

curl -X POST http://www.translateapi.ai/api/v1/translate/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "Hello, world!",
    "target_language": "es"
  }'

import requests

response = requests.post(
    "http://www.translateapi.ai/api/v1/translate/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "text": "Hello, world!",
        "target_language": "es"
    }
)

result = response.json()
print(result["translated_text"])  # "Hola, mundo!"

const response = await fetch("http://www.translateapi.ai/api/v1/translate/", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        text: "Hello, world!",
        target_language: "es"
    })
});

const result = await response.json();
console.log(result.translated_text);  // "Hola, mundo!"

Authentication

Authenticate your requests using an API key. You can create API keys from your dashboard.

Header Authentication (Recommended)

Authorization: Bearer ta_your_api_key_here

Query Parameter

http://www.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here

Translate Text

Translate text to a single target language.

{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "character_count": 13
}

Multi-Target Translation

Translate text to multiple languages in a single request.

{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

{
    "translations": {
        "es": "Hola, mundo!",
        "fr": "Bonjour, monde!",
        "de": "Hallo, Welt!",
        "ja": "こんにちは、世界！"
    },
    "source_language": "en",
    "character_count": 13
}

Batch Translation

Translate multiple texts to a single language in one request.

{
    "texts": ["Hello", "Goodbye", "Thank you"],
    "target_language": "es",
    "source_language": "en"
}

{
    "translations": ["Hola", "Adios", "Gracias"],
    "source_language": "en",
    "target_language": "es",
    "character_count": 22
}

Language Detection

Detect the language of a text.

{
    "text": "Bonjour, comment allez-vous?"
}

{
    "language": "fr",
    "confidence": 0.98
}

Supported Languages

Get the list of all supported languages.

{
    "languages": [
        {"code": "en", "name": "English", "native_name": "English"},
        {"code": "es", "name": "Spanish", "native_name": "Espanol"},
        {"code": "fr", "name": "French", "native_name": "Francais"},
        ...
    ],
    "count": 200
}

Error Handling

The API uses standard HTTP status codes to indicate success or failure.

Error Response Format

{
    "error": "Description of the error"
}

Rate Limits

Rate limits vary by plan:

When you exceed your rate limit, you'll receive a 429 Too Many Requests response.