Translate HTML

Translate HTML content while preserving all tags, attributes, and document structure.

Endpoint

POST /v2/translate/html

Headers

X-API-KEY string (required) : Your API key for authentication

Content-Type string (required) : Must be application/json

Request Parameters

Body Parameters

html string (required) : The HTML content to translate (1-50000 characters)

source string (required) : Source language code (e.g., "en", "fr") or "auto" for auto-detection

target string (required) : Target language code (e.g., "en", "fr")

Example Request

curl https://api.translateplus.io/v2/translate/html \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<p>Hello <b>world</b>! This is a <span>test</span>.</p><p>Line two: <i>How are you?</i></p>",
    "source": "en",
    "target": "fr"
  }'

Success Response (200 OK)

{
  "html": "<p>Bonjour <b>monde</b> ! C'est un <span>test</span>.</p><p>Ligne deux : <i>Comment allez-vous ?</i></p>"
}

Response Fields

Features

• Tag Preservation: All HTML tags and attributes are preserved exactly as provided
• Structure Maintenance: Document structure and nesting are maintained
• Script & Style Skipping: Content inside <script> and <style> tags is not translated
• Nested Tags: Handles complex nested HTML structures correctly
• HTML Entities: Properly handles HTML entities and special characters

Error Responses

400 Bad Request

Invalid request parameters:

{
  "detail": "Invalid language code 'xx'. Supported codes: en, fr, es..."
}

402 Payment Required

Insufficient credits:

{
  "detail": "Insufficient credits. You have 0 credit(s) remaining, but this request requires 1 credit(s). Please upgrade your plan to continue using the API."
}

403 Forbidden

Invalid or missing API key:

{
  "detail": "API key is required. Please provide X-API-KEY header."
}

429 Too Many Requests

Rate limit exceeded:

{
  "detail": "Rate limit exceeded. You have made 60 requests. Maximum allowed: 60 requests per minute. Please try again after 45 seconds."
}

Credits

This endpoint requires 1 credit per request.