Humanize Text API

Rewrite AI-sounding or formal text to read more naturally using deterministic, rule-based transformations.

Get your API token

Create an account and subscribe ($9/month) to start using the API.

Create account Sign in

Overview

The Humanize Text API rewrites text using a deterministic pipeline — no ML, no randomness. The same input with the same settings always produces the same output. Three top-level settings control the transformation: language, mode, and strength.

Protected spans (code blocks, inline code, URLs) are never modified.
Paragraph structure and line breaks are preserved.
Strength 0 = punctuation normalization only. Strength 100 = all rules applied.

Endpoint

POST /api/humanize

Content-Type: application/json or application/x-www-form-urlencoded

Authentication

Include your API token in every request:

Query parameter: ?token=YOUR_TOKEN
Body field: token=YOUR_TOKEN
Header: Authorization: Bearer YOUR_TOKEN

Request Parameters

Parameter	Type	Required	Description
`text`	string	Yes	The text to humanize (max 20,000 characters).
`lang`	string	Yes	Language code: `en`, `lt`, `ru`, `pl`, or `et`.
`mode`	string	Yes	Transformation style: `clarify`, `simplify`, or `conversational`.
`strength`	integer	No	Transformation intensity, 0–100. Default: `40`.

Mode reference

Mode	Effect
`clarify`	Replaces jargon/bureaucratic phrases with clearer alternatives. Keeps a professional tone.
`simplify`	Replaces complex phrases with simpler words. Splits long sentences. Merges very short ones.
`conversational`	Casual rewrites, contractions (English), colloquial connectors.

Transformation Pipeline

Mask protected spans — code blocks, inline code, and URLs are stored and restored unchanged.
Punctuation normalization — always applied; fixes double spaces, space-before-punctuation, repeated commas.
Phrase replacement — applied when strength > 0. Replaces formal/bureaucratic phrases with natural alternatives. More phrases active at higher strength.
Sentence processing — applied when strength ≥ 20: splits long sentences at semicolons or conjunctions; reduces repeated sentence starters by prepending connectors.
Short sentence merging — applied in simplify / conversational mode with strength > 60: merges adjacent very short sentences.
Contractions — English + conversational + strength ≥ 30 only (e.g. do not → don't).
Final cleanup — whitespace normalisation, line trimming.
Unmask — protected spans are restored.

Example Request

POST /api/humanize?token=YOUR_TOKEN
Content-Type: application/json

{
  "text": "It should be noted that this is a very important matter. It should be noted that further investigation is required.",
  "lang": "en",
  "mode": "conversational",
  "strength": 60
}

Example Response

{
  "success": true,
  "data": {
    "result": "Worth noting, this is a very important matter. Plus, further investigation is needed.",
    "lang": "en",
    "mode": "conversational",
    "strength": 60
  }
}

Error Responses

HTTP Status	Reason
`401`	Missing or invalid API token.
`403`	No active subscription.
`422`	Missing required field or invalid value (e.g. unsupported lang/mode, text too long).