Docs menuAPI Reference

API ReferenceTyped request and response

API Reference

TurnitPass REST API

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

Reference console

Start with the route, payload, and response shape.

The full reference covers every endpoint below. The console shows the contract developers need first: Bearer auth, JSON input, metered output, and status checks.

request

POST

fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})

response

200 OK

{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}

meteredloggedJSON

POST/api/v1/humanize

POST/api/v1/paraphrase

POST/api/v1/rewrite

POST/api/v1/detect

POST/api/v1/citation

AuthBearer API key

TransformPOST /humanize

ReviewPOST /detect

StatusGET /status

POST/api/v1/humanize

Revise submitted text and reduce AI-like writing signals. Modes: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase

Rewrite and polish text with standard, fluency, formal, academic, simple, creative, expand, or shorten modes.

POST/api/v1/rewrite

Academic polish endpoint for cleaner structure, tone, and sentence flow.

POST/api/v1/detect

Return AI-writing signal estimates, metadata, and revision notes for pasted text or extracted documents.

POST/api/v1/citation

Format a DOI, URL, or manual citation in APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA, or Bluebook. Responses include html, text, BibTeX, and RIS.

POST/api/v1/bibliography

Sort and format a list of citations in the requested style, with html/text output plus BibTeX and RIS exports.

GET/api/v1/status

Check key label, remaining word balance, and request limits.

Parameters and options

Auth

Authorization: Bearer tp_live_your_api_key

Humanize terms

Optional personal_terms array preserves names, technical terms, and brand spellings during English humanization.

Limits

Transform endpoints accept up to 1,000 input words. Detection accepts up to 5,000 words. Citation endpoints are rate-limited but do not spend word credits.

Errors

JSON responses include error, code, and message fields.

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "Paste the AI-assisted draft you want to revise",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["Key term"]
}

200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Paste the draft you want rewritten",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Paste the draft you want checked",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "Formatted citation...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Next steps

Quickstart

Set up the first request.

Authentication

Review API key handling.

Changelog

See recent platform changes.

fetch('/api/v1/humanize', { method: 'POST', headers: { Authorization: 'Bearer tp_live_your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ text: 'Paste the draft here', language: 'en', mode: 'reduce-aigc' }) })

Parameters and options

Auth

Authorization: Bearer tp_live_your_api_key

Humanize terms

Optional personal_terms array preserves names, technical terms, and brand spellings during English humanization.

Limits

Transform endpoints accept up to 1,000 input words. Detection accepts up to 5,000 words. Citation endpoints are rate-limited but do not spend word credits.

Errors

JSON responses include error, code, and message fields.

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "Paste the AI-assisted draft you want to revise",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["Key term"]
}

200 OK
{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Paste the draft you want rewritten",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Paste the draft you want checked",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "Formatted citation...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}