Browse documentation

TurnitPass API documentation

Start with API keys, call humanizer, paraphrase, detector, citation, and bibliography endpoints, and wire TurnitPass into your own writing product.

REST API v1

One request

Quick example

Send text to the humanizer endpoint with a Bearer API key. The response returns the transformed output, words used, and the remaining word balance for the key owner.

curl

POST /api/v1/humanize

1curl -X POST https://turnitpass.com/api/v1/humanize \
2  -H "Authorization: Bearer tp_live_your_api_key" \
3  -H "Content-Type: application/json" \
4  -d '{"text":"Paste your draft here","language":"en","mode":"revise"}'

response

200 OK

1{
2  "output": "Your humanized text...",
3  "words_used": 6,
4  "words_remaining": 249994
5}

TurnitPass also exposes paraphrase, rewrite, detector, citation, bibliography, and status endpoints from the same API-key flow.

Route map

Explore the docs

Quickstart

Create an API key from your workspace, then call humanize, detect, and citation endpoints with your API key.

Authentication

Developer requests use API keys generated from your TurnitPass workspace.

API Reference

Reference for authenticated humanization, paraphrase, detector, citation, bibliography, and API key status endpoints.

Changelog

Recent platform changes across the humanizer, AI detector, writing tools, billing, and API.

Make your first humanization request

Create a key and make the first request.

TurnitPass REST API

Review endpoints, parameters, limits, and response shapes.

Next step

Request lifecycle

Every TurnitPass API call follows the same product path: authenticate the key, validate the payload, run the writing or citation workflow, meter usage, and return a response shape that can be stored by your product.

Authenticate the API key

Send an API key generated from the workspace. Revoked, malformed, or missing keys fail before text processing starts.

Validate text, language, and limits

Transform requests enforce word ranges, detector requests enforce longer scan limits, and citation requests validate style and source input.

Run the workflow

Humanize, paraphrase, rewrite, detect, citation, and bibliography routes behave consistently with the public tools.

Record usage and return output

Successful calls return output plus usage metadata such as words used, remaining balance, status details, or formatted citation exports.

API Surface

Core endpoints

Revise

POST/api/v1/humanize

Revise AI-assisted text while preserving meaning.

Paraphrase

POST/api/v1/paraphrase

Rewrite and polish text in multiple modes.

Detect

POST/api/v1/detect

Return AI-writing signal estimates and revision notes.

Citations

POST/api/v1/citation

Format DOI, URL, or manual source metadata.

Production checklist

Server-side calls

Never expose API keys in client bundlesCall TurnitPass from your backend, worker, queue, or protected server action.

Retry behavior

Retry network failures, not validation failuresHandle 4xx responses as user or payload issues and reserve retries for transient 5xx/network errors.

Word budgets

Show remaining balance before heavy flowsUse the status endpoint to decide whether to queue a job, ask for upgrade, or split a document.

Billing setup

Plan-aware limitsCheckout, the customer portal, and webhooks keep usage and subscriptions aligned.

For product integrations, keep one TurnitPass key per environment. Production, staging, and local development should be revocable independently.

Next, make it part of your workflow.Continue reading