Humanizio API

Three JSON endpoints: Humanize, Humanize + SEO, and Humanize + GEO. Simple bearer-key auth, one POST, natural writing back.

Authentication

Generate an API key in your dashboard, then send it as a bearer token. Every call counts against your plan's monthly allowance, so keep your key secret.

Authorization: Bearer hz_live_xxxxxxxxxxxxxxxxxxxx

Add-on endpoints (/v1/seo, /v1/geo) require a paid plan with the matching add-on enabled.

Base URL & limits

POST /v1/humanize

Rewrites AI-drafted text into natural, human writing while preserving meaning and structure.

Request body

{ "text": "Your AI-drafted text (≥ 20 words)…" }

curl https://humanizio-api.nanoo-shashwat.workers.dev/v1/humanize \
  -H "Authorization: Bearer hz_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"text":"In today'"'"'s rapidly evolving landscape, organizations must leverage..."}'

Response

{ "humanized": "Businesses today need to use…", "word_count": 128 }

POST /v1/seo

Inserts a target keyword the smart way (title, a heading, the opening, natural variants elsewhere), then humanizes — and returns a placement report and 0–100 SEO score. Requires the SEO add-on.

Request body

{ "text": "…", "keyword": "project management software" }

Response (abridged)

{
  "humanized": "…",
  "markdown": "# … formatted article …",
  "mode": "seo",
  "keyword": "project management software",
  "word_count": 812,
  "report": {
    "seo_score": 100,
    "keyword_density_pct": 1.2,
    "checklist": { "in_title": true, "in_a_heading": true, "in_first_100_words": true, "has_2plus_headings": true },
    "readability_flesch": 58.4
  }
}

POST /v1/geo

Optimizes content to be cited by AI answer engines (statistics, citations, direct answers), then humanizes. Unverifiable additions are marked [verify: …] — fill them with real sources before publishing. Requires the GEO add-on.

Request body

{ "text": "…", "keyword": "optional topic or question" }

Response (abridged)

{
  "humanized": "…",
  "markdown": "…",
  "mode": "geo",
  "word_count": 905,
  "report": {
    "statistics_surfaced": 3,
    "citation_placeholders": 2,
    "levers_applied": ["statistics_present","question_headings","citation_placeholders"],
    "warning": "Replace every [verify: …] placeholder with a real, checked source before publishing."
  }
}

Errors

Errors return a JSON { "error": "…" } with an HTTP status:

Get your API key