Docs menuRiferimento API

API ReferenceTyped request and response

Riferimento API

API REST TurnitPass

Riferimento per gli endpoint autenticati di umanizzazione, parafrasi, rilevamento, citazione, bibliografia e stato delle chiavi API.

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

Rende più naturale il testo inviato e riduce i segnali IA. Modalità: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase

Riscrivi e perfeziona il testo con modalità standard, fluidità, formale, accademico, semplice, creativo, espandi o accorcia.

POST/api/v1/rewrite

Endpoint di pulizia accademica per una migliore struttura, tono e flusso delle frasi.

POST/api/v1/detect

Restituisce punteggio stimato, livello di rischio, metadati e segnali di scrittura per testo incollato o documenti estratti.

POST/api/v1/citation

Formatta DOI, URL o citazione manuale in APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA o Bluebook. Le risposte includono HTML, testo semplice, BibTeX e RIS.

POST/api/v1/bibliography

Ordina e formatta un elenco di citazioni nello stile richiesto, con output HTML/testo ed esportazioni BibTeX e RIS.

GET/api/v1/status

Controlla il nome della chiave, il saldo parole rimanente, i limiti di richiesta e l’ultimo utilizzo.

Parameters and options

Autenticazione

Authorization: Bearer tp_your_api_key

Termini protetti

Il campo opzionale personal_terms preserva nomi propri, termini tecnici e marchi durante la revisione.

Limits

Gli endpoint di trasformazione accettano fino a 1.000 parole in ingresso. Il rilevamento accetta fino a 5.000 parole. Gli endpoint di citazione sono limitati ma non consumano crediti di parole.

Errors

Le risposte JSON includono i campi error, code e message.

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": "Incolla qui la bozza da rivedere",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "Il testo umanizzato...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Incolla la bozza che desideri riscrivere",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Incolla il testo da controllare",
  "language": "en",
  "source_kind": "paste"
}

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

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

Next steps

Guida rapida

Set up the first request.

Autenticazione

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

Autenticazione

Authorization: Bearer tp_your_api_key

Termini protetti

Il campo opzionale personal_terms preserva nomi propri, termini tecnici e marchi durante la revisione.

Limits

Gli endpoint di trasformazione accettano fino a 1.000 parole in ingresso. Il rilevamento accetta fino a 5.000 parole. Gli endpoint di citazione sono limitati ma non consumano crediti di parole.

Errors

Le risposte JSON includono i campi error, code e message.

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": "Incolla qui la bozza da rivedere",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "Il testo umanizzato...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Incolla la bozza che desideri riscrivere",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Incolla il testo da controllare",
  "language": "en",
  "source_kind": "paste"
}

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

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