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:

Sizing Guide - For particularly large or small requests
Special Characters & Encoding - For code, HTML, or special characters
API Limits - Understanding rate limits and constraints

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.