API تشخیص تقلب: ارسال متن، پرس و جو گزارش.

چند تا نقطه انتهايي، امضاي حامل، قيمت شفافي اعتباري براي آژانس ها، خط توليد و ابزارهاي مجاور LMS ساخته شده

کلید API شما

برای دریافت کلید API وارد شوید. هر حساب یک کلید دارد؛ بررسی‌های API با اعتبار محاسبه می‌شوند.

ثبت نام

نقطه پایانی

POST /api/v1/check/

ارسال متن برای بررسی. پاسخ 202 همراه با check_id برمی‌گرداند. بدنه: JSON با فیلد text و فیلد اختیاری بولی deep.

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/

فهرست بررسی‌های اخیر شما، از جدیدترین به قدیمی‌ترین. پارامترهای اختیاری پرس‌وجو: limit (از 1 تا 100، پیش‌فرض 20) و status (queued، done، failed و غیره). ثبت‌ها را تطبیق دهید و داشبورد خودتان را بدون ذخیره هر check_id پشتیبانی کنید.

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

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

یک بررسی تمام‌شده را حذف می‌کند: متن ارسال‌شده و گزارش آن برای همیشه پاک می‌شوند. از آن برای انجام درخواست‌های حذف کاربران خودتان استفاده کنید. بررسی‌ای که هنوز در صف است یا در حال اجراست پاسخ 409 می‌دهد؛ پس از پایان یا شکست آن را حذف کنید.

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 اعتبار = 1,000 کلمه اسکن‌شده که برای هر بررسی به بالا گرد می‌شود؛ بررسی‌های عمیق دو برابر هزینه دارند. بسته‌های اعتباری 365 روز معتبر هستند؛ اشتراک‌ها ماهانه شارژ می‌شوند و در هر سطح شامل API هستند. سطح جداگانه‌ای برای API و هزینه‌ای برای هر کاربر وجود ندارد. نقشه‌ها و بسته‌ها را ببینید

بررسی‌ها به‌صورت ناهمزمان اجرا می‌شوند: بازیابی واقعی وب که محدودیت نرخ دارد، معمولاً پس از شروع بررسی حدود یک دقیقه طول می‌کشد و برای اسناد بلندتر و در زمان‌های شلوغ بیشتر. به جای باز نگه داشتن اتصال، نقطه پایانی وضعیت را پرس‌وجو کنید. کد HTTP 402 یعنی اعتبار کافی نیست؛ پاسخ شامل هزینه بررسی نیز هست.

پرسش‌های متداول

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.