REST API Reference

Integrate GPT Scrambler text humanization into any application or workflow using the REST API.

Use the same API key for the REST API and the MCP server (@gptscrambler/mcp-server on npm). Setup guide: MCP & API.

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_your_key_here

Generate your key in Settings → API Access. The raw key is shown only once — store it securely. You can regenerate or revoke it at any time.

New accounts receive 200 free API trial words (apiTrialBalance), separate from the web app word balance. Paid API plan usage draws from your main account balance.

Base URL

https://gptscrambler.com

Endpoints

POST `/api/v1/humanize`

Humanize a piece of text.

Request body

Field	Type	Required	Description
`text`	`string`	✓	Text to humanize
`language`	`string`	—	BCP 47 language code (e.g. `en`, `de`). Defaults to auto-detect.
`mode`	`"standard"` \| `"aggressive"`	—	Rewrite strength. Default: `standard`.

Example

curl -X POST https://gptscrambler.com/api/v1/humanize \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Artificial intelligence is revolutionizing the way businesses operate.",
    "mode": "standard"
  }'

Response

{
  "humanized_text": "AI is changing how companies function.",
  "words_used": 11,
  "balance_remaining": 489
}

GET `/api/v1/balance`

Check your remaining word balance and billing period.

Example

curl https://gptscrambler.com/api/v1/balance \
  -H "Authorization: Bearer sk_live_your_key_here"

Response

{
  "balance_remaining": 489,
  "plan": "api",
  "reset_date": "2026-06-20T00:00:00.000Z"
}

reset_date is null for non-subscription plans.

Error responses

All errors follow this shape:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Code	HTTP	Description
`invalid_api_key`	401	Key not found, revoked, or missing from `Authorization` header
`insufficient_balance`	402	Not enough words remaining in the account
`trial_exhausted`	403	Free trial exhausted; an active API subscription is required
`text_too_short`	400	Input has fewer than 10 words
`text_too_long`	400	Input exceeds 3,000 words
`rate_limit_exceeded`	429	Exceeded 60 requests per hour per API key