Watermark Detection API

Tinkrr watermarks coach text in multiple ways. This API returns a single Tinkrrness score from 0–100 — higher means the text is more likely to have come from Tinkrr.

No account needed to try it: paste text on the public checker.

How to use

Send your API key on every request using the x-tinkrr-api-key header, or Authorization: Bearer YOUR_API_KEY.

Keys are free with any Tinkrr account. Create an account or use the panel above while signed in.

Endpoint

POST /api/watermark/v2/detect

Discovery: GET /api/watermark/v2/detect

Request body

• text (string, required) — text to check, up to 50,000 characters.
• age (number, optional) — child age 4–18, if known.

Response

• tinkrrnessScore — 0–100. Higher is more likely Tinkrr.

Example request

curl -X POST https://tinkrr.ai/api/watermark/v2/detect \
  -H "Content-Type: application/json" \
  -H "x-tinkrr-api-key: YOUR_API_KEY" \
  -d '{
    "text": "That is a wonderful question! Let me help you understand this problem step by step."
  }'

Example response

{
  "ok": true,
  "tinkrrnessScore": 92,
  "meta": {
    "version": 2,
    "textLength": 89
  }
}

Errors

• 401 — missing or invalid API key.
• 400 — invalid JSON or missing text.
• 413 — text too long.
• 503 — detection service not configured on server.

Privacy

Send only text you are allowed to analyze. Tinkrr does not store detection API payloads unless your deployment adds separate logging. See our Privacy Policy.

Support

Questions? Email contact@tinkrr.ai or visit the knowledge base.