Plagiarisme - opsporing API: stuur teks neer, sê die verslag.

'n Handvol punte, draer' nuth, deursigtige kredietprysing. Gebou vir agentskappe, redaksionele pypleidings en LMS-dalade gereedskap.

Jou API-sleutel

Teken in om jou API-sleutel te kry. Sleutels kom met elke rekening; API-kontroles word in krediete aangeteken.

Meld op

Einde punt:

POST /api/v1/check/

Dien ’n teks in vir kontrole. Gee 202 terug met ’n check_id. Liggaam: JSON met ’n text-veld en opsionele deep-boolean.

curl -X POST https://plagiarism.free/api/v1/check/ \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "The text you want to check..."}'

GET /api/v1/check/<check_id>/

Pos vir status; wanneer status is klaar die volledige raporteer is ingesluit: telling, per-enteniteit ooreenstem tipes met vertroue en bron uittreksels, en die bronlys.

curl https://plagiarism.free/api/v1/check/CHECK_ID/ \
  -H "Authorization: Bearer YOUR_KEY"

GET /api/v1/checks/

Lys jou onlangse kontroles, nuutste eerste. Opsionele navraagparameters: limit (1 tot 100, standaard 20) en status (queued, done, failed...). Versoen indienings en voed jou eie paneelbord sonder om elke check_id te stoor.

curl "https://plagiarism.free/api/v1/checks/?limit=20&status=done" \
  -H "Authorization: Bearer YOUR_KEY"

DELETE /api/v1/check/<check_id>/

Delete a finished check: the submitted text and its report are removed for good. Use it to honour your own users' deletion requests. A check that is still queued or running answers 409; delete it once it is done or failed.

curl -X DELETE https://plagiarism.free/api/v1/check/CHECK_ID/ \
  -H "Authorization: Bearer YOUR_KEY"

Python-voorbeeld

import time
import requests

API = "https://plagiarism.free/api/v1/check/"
HEADERS = {"Authorization": "Bearer YOUR_KEY"}

r = requests.post(API, json={"text": open("essay.txt").read()}, headers=HEADERS)
check_id = r.json()["check_id"]

while True:
    report = requests.get(f"{API}{check_id}/", headers=HEADERS).json()
    if report["status"] in ("done", "failed"):
        break
    time.sleep(3)

print(report["score_pct"], "% matched")
for source in report["sources"]:
    print(source["pct_of_document"], source["url"])

JavaScript voorbeeld

const API = "https://plagiarism.free/api/v1/check/";
const headers = { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" };

const { check_id } = await fetch(API, {
  method: "POST", headers, body: JSON.stringify({ text })
}).then(r => r.json());

let report;
do {
  await new Promise(res => setTimeout(res, 3000));
  report = await fetch(`${API}${check_id}/`, { headers }).then(r => r.json());
} while (!["done", "failed"].includes(report.status));

Comment

Identies aan die webwerf: 1 krediet = 1,000 woorde geskandeer, per kontrole afgerond na bo; diepkontroles kos dubbel. Kredietpakkies is 365 dae geldig; intekeninge word maandeliks aangevul en sluit die API op elke vlak in. Geen aparte API-vlak nie, geen gelde per sitplek nie. Sien planne en pakkies

Kontroles loop asynchroon: werklike, tempo-beperkte webherwinning neem gewoonlik ongeveer ’n minuut sodra ’n kontrole begin, langer vir lang dokumente en op besige tye. Vra die statuseindpunt op in plaas van die verbinding oop te hou. HTTP 402 beteken onvoldoende krediete; die antwoord sluit in wat die kontrole sou kos.

Dikwels gevra vrae

Two endpoints. POST /api/v1/check/ with your text returns a check_id; GET /api/v1/check/check_id/ returns status while the check runs and the full report JSON (score, matched sentences, sources) when done. Auth is a Bearer key from your account page. Code samples in curl, Python and JavaScript are below.

The same transparent unit as the site: 1 credit per 1,000 words scanned, rounded up per check. Credit packs start at $4.99 for 30 credits and are valid a full year; the $7.99/month Starter plan includes 60 credits and API access. No per-seat fees, no separate API pricing tier.

A check usually takes about a minute once it starts, longer for long documents, because it performs real, rate-limited web retrieval and page comparison. The API is asynchronous for that reason. Submissions queue fairly; paid checks get priority. Poll the status endpoint every few seconds rather than holding the connection open.

Everything the web report shows: overall matched percentage, per-sentence match type (exact / near / none) with confidence, the matched source excerpt for each flagged sentence, and the source list with URLs and per-source match percentages. Enough to render your own report UI or gate a workflow.

Yes - that is what it is for: LMS-adjacent tools, editorial workflows, agency content pipelines. Volume is metered purely by credits, and the per-check word cap is 25000 words. If you need sustained high volume, contact us and we will provision for it rather than let queues degrade.