ئەپی ئی ئێپی بۆ دۆزینەوەی ناپاکی: نوسراوەکە بنێرە، ڕاپۆرتەکە بپرسە.

چەند خاڵێکی کۆتایی، ڕاستی خاوەنی، نرخی پارە بە ئاشکرا. بۆ ئاژانسەکان دروستکراوە، پڕۆسەی نووسین و ئامرازەکانی LMS-ی نزیک.

کلیلی API ی خۆت

بۆ بەدەستهێنانی کلیلی API خۆت بچۆرە ناوەوە. کلیلەکان لەگەڵ هەموو حسابێکدا دێن، پشکنینی API بە کرێدیتەکان دادەنرێت.

_بنەما

خاڵەکانی کۆتایی

POST /api/v1/check/

نوسراوێک بۆ پشکنین بنێرە. 202 دەگەڕێنێتەوە لەگەڵ ناسنامەی پشکنین. جەستە: JSON لەگەڵ بەشی نوسین، هەڵبژاردەی قووڵی بولێن.

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>/

بۆ دۆخی دەنگدان؛ کاتێک دۆخەکە تەواو دەبێت ڕاپۆرتەکە تەواو دەبێت: ئەنجام، بۆ هەر رستەیەک جۆری هاوتا لەگەڵ متمانە و سەرچاوەی بەشەکان، وە لیستی سەرچاوەکە.

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

GET /api/v1/checks/

لیستی پشکنینەکانی دوایینت بنووسە، یەکەم جار نوێترین. پارامەترەکانی پرسیاری هەڵبژێردراو: سنوور (1-100، پێشنیارکراو 20) و دۆخ (لە ڕیزدا، تەواو، شکست...). رێکخستنی پێشکەشکردنەکان و پشتگیری کردن لە داتابەیسەکەت بەبێ تۆمارکردنی هەموو پشکنین_هەژمارەکە.

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"

نمونەی پایتۆن

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"])

نمونەی جاڤاسکریپت

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));

نرخ

. هەمان شوێن: 1 کرێدیت = 1000 وشەیە کە گەڕێنراونەتەوە، بۆ هەر پشکنینێک گەڕێنراوە؛ پشکنینەکانی قووڵ دووجار پارە دەگرن. 365 ڕۆژ پابەندن بە پابەندبوون؛ بەشداربوون مانگانە پڕدەکاتەوە و API لە هەموو ئاستێکدا دەگرێت. هیچ پلەی API یەکی تایبەت نییە، هیچ پارەیەکی بۆ هەر جێگەیەک نییە. پلان و پشکەکان ببینە

Checks run asynchronously: real, rate-limited web retrieval usually takes about a minute once a check starts, longer for long documents and at busy times. Poll the status endpoint rather than holding the connection open. HTTP 402 means insufficient credits; the response includes what the check would cost.

پرسیاری زۆر کراوە

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.