Create a Translation Request

Send the content you need to translate.

Choose Your Request Type

We offer two options for submitting content:

Translation Request

Posting a Translation Request immediately orders and processes your content. For paid languages, your account will be charged automatically. You can test for free using Tolq Latin (tq).

Quote Request

Posting a Quote Request lets you review content and pricing before committing. Create a quote by adding /quote to the API endpoint. You can then approve orders through the UI or API.


Before you start

Review these important considerations:


Example request

Let's translate a CMS article with title, introduction, and body text. We'll use Tolq Latin (tq) as the target language for free testing.

Request JSON:

{ "request": { "title": { "text": "The example" }, "intro": { "text": "An example on how to use Tolq" }, "body": { "text": "Tolq is a platform that allows you easily translate lots of content." } }, "source_language_code": "en", "target_language_codes": "tq", "quality": "machine" }

Response:

{ "id": 1, "name": null, "slug": "untitled-1", "context_url": null, "description": null, "created_at": "2016-03-02T10:23:32.441Z", "completed_at": null, "quality": "machine", "target_language_code": "tq", "style_guide_reference_id": 1, "status": "pending" }

Using the response

The successful response includes an id that you can use to:

  • Retrieve your translation when it's completed
  • Search and identify the request in your client application
  • Handle callbacks for status updates

For details on request lifecycle, see the status documentation.


Content Metadata

Each translatable item supports these optional properties:

Text content

{ "text": "Your content here" }

Markdown content

{ "text": "# Your markdown content", "commonmark": true }

Set commonmark: true for content in CommonMark markdown format. Markdown is not auto-detected.

HTML content

{ "text": "<p>Your HTML content</p>", "html": true }

Set html: true for HTML content. The parser will extract only translatable text, preserving HTML structure. HTML is auto-detected, but this property overrides detection.