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:
- 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.