Docs menuReferencia de API

API ReferenceTyped request and response

Referencia de API

API REST de TurnitPass

Referencia para los endpoints autenticados de revisión, paráfrasis, comprobación de señales, citas, bibliografía y estado de claves.

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

Revisa el texto enviado y reduce señales de escritura tipo IA. Modos: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase

Reescribe y pule el texto con modos estándar, fluidez, formal, académico, simple, creativo, expandir o acortar.

POST/api/v1/rewrite

Endpoint de revisión académica para una mejor estructura, tono y fluidez.

POST/api/v1/detect

Devuelve puntaje, nivel de riesgo, metadatos y señales de escritura para el texto pegado o documentos extraídos.

POST/api/v1/citation

Formatea un DOI, URL o cita manual en APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA o Bluebook. La respuesta incluye HTML, texto plano, BibTeX y RIS.

POST/api/v1/bibliography

Ordena y formatea una lista de citas en el estilo solicitado, con salida HTML/texto y exportación en BibTeX y RIS.

GET/api/v1/status

Verifica el nombre de la clave, saldo de palabras restante, límites de solicitud y último uso.

Parameters and options

Autenticación

Authorization: Bearer tp_your_api_key

Términos protegidos

El campo opcional personal_terms conserva nombres propios, términos técnicos y marcas.

Límites

Los endpoints de revisión aceptan hasta 1.000 palabras de entrada. La comprobación acepta hasta 5.000 palabras. Las citas tienen límites de uso propios.

Errores

Las respuestas JSON incluyen error, code y 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": "Pega el texto que quieres revisar",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "El texto humanizado...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Pega el borrador que quieres reescribir",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Pega el texto que quieres comprobar",
  "language": "en",
  "source_kind": "paste"
}

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

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

Next steps

Inicio rápido

Set up the first request.

Autenticación

Review API key handling.

Historial

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

Autenticación

Authorization: Bearer tp_your_api_key

Términos protegidos

El campo opcional personal_terms conserva nombres propios, términos técnicos y marcas.

Límites

Los endpoints de revisión aceptan hasta 1.000 palabras de entrada. La comprobación acepta hasta 5.000 palabras. Las citas tienen límites de uso propios.

Errores

Las respuestas JSON incluyen error, code y 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": "Pega el texto que quieres revisar",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["TurnitPass"]
}

200 OK
{
  "output": "El texto humanizado...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Pega el borrador que quieres reescribir",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Pega el texto que quieres comprobar",
  "language": "en",
  "source_kind": "paste"
}

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

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