Developer API

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://turniscan.com/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Submit document
with open("thesis.docx", "rb") as f:
    res = requests.post(
        f"{BASE_URL}/scan/submit",
        headers=HEADERS,
        files={"file": f},
        data={
            "server": "s1", // "s1" (up to 50,000 words) or "s2" (up to 3,50,000 words)
            "service_type": "Turnitin Plagiarism",
            "exclude_quotes": "1",
            "exclude_biblio": "1",
            "exclude_citations": "1",
            "exclude_small_matches": "1",
            "small_match_threshold": "10",
            "custom_id": "order_9812"
        }
    ).json()

file_id = res["file_id"]
print(f"Submitted successfully! File ID: {file_id}")

# 2. Poll status until completed
while True:
    st = requests.get(f"{BASE_URL}/scan/status", headers=HEADERS, params={"file_id": file_id}).json()
    if st.get("status") == "Completed":
        print(f"Done! Similarity: {st['similarity_score']}%, AI: {st['ai_score']}%")
        break
    elif st.get("status") == "Failed":
        print("Scan failed:", st.get("error"))
        break
    time.sleep(10)

# 3. Download PDF report
pdf_resp = requests.get(f"{BASE_URL}/scan/download", headers=HEADERS, params={"file_id": file_id})
with open("Turnitin_Report.pdf", "wb") as f:
    f.write(pdf_resp.content)
print("Saved report to Turnitin_Report.pdf")

# 4. Delete file from storage (Optional: auto-purged after 24h)
requests.post(f"{BASE_URL}/scan/delete", headers=HEADERS, json={"file_id": file_id})
print("File and report purged from storage.")

<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://turniscan.com/v1';

// 1. Submit Document
$ch = curl_init("$baseUrl/scan/submit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $apiKey"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'file' => new CURLFile('/path/to/thesis.docx'),
    'server' => 's1', // s1: up to 50,000 words | s2: up to 3,50,000 words
    'service_type' => 'Turnitin Plagiarism',
    'exclude_quotes' => '1',
    'exclude_biblio' => '1',
    'exclude_citations' => '1',
    'exclude_small_matches' => '1',
    'small_match_threshold' => '10',
    'custom_id' => 'order_9812'
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

$fileId = $response['file_id'];
echo "File ID: " . $fileId . PHP_EOL;

// 2. Download report once finished
$downCh = curl_init("$baseUrl/scan/download?file_id=$fileId");
$fp = fopen('Turnitin_Report.pdf', 'w+');
curl_setopt($downCh, CURLOPT_FILE, $fp);
curl_setopt($downCh, CURLOPT_HTTPHEADER, ["Authorization: Bearer $apiKey"]);
curl_exec($downCh);
curl_close($downCh);
fclose($fp);
echo "Report saved to Turnitin_Report.pdf" . PHP_EOL;

// 3. Delete file from storage (Optional: auto-purged after 24h)
$delCh = curl_init("$baseUrl/scan/delete");
curl_setopt($delCh, CURLOPT_POST, true);
curl_setopt($delCh, CURLOPT_HTTPHEADER, ["Authorization: Bearer $apiKey"]);
curl_setopt($delCh, CURLOPT_POSTFIELDS, ['file_id' => $fileId]);
curl_setopt($delCh, CURLOPT_RETURNTRANSFER, true);
curl_exec($delCh);
curl_close($delCh);
echo "File purged from storage." . PHP_EOL;
?>

import fs from 'fs';
import FormData from 'form-data';
import fetch from 'node-fetch';

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://turniscan.com/v1';

async function scanDocument() {
  const form = new FormData();
  form.append('file', fs.createReadStream('./thesis.docx'));
  form.append('server', 's1'); // s1: up to 50k words | s2: up to 350k words
  form.append('service_type', 'Turnitin Plagiarism');
  form.append('exclude_quotes', '1');
  form.append('exclude_biblio', '1');
  form.append('exclude_citations', '1');
  form.append('exclude_small_matches', '1');
  form.append('small_match_threshold', '10');
  form.append('custom_id', 'order_9812');

  const res = await fetch(`${BASE_URL}/scan/submit`, {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${API_KEY}`, ...form.getHeaders() },
    body: form
  });

  const result = await res.json();
  console.log('Submitted:', result);

  // Download PDF
  const pdfRes = await fetch(`${BASE_URL}/scan/download?file_id=${result.file_id}`, {
    headers: { 'Authorization': `Bearer ${API_KEY}` }
  });
  const fileStream = fs.createWriteStream('./final_report.pdf');
  pdfRes.body.pipe(fileStream);
  console.log('Saved to final_report.pdf');

  // Delete file from storage (Optional: auto-purged after 24h)
  await fetch(`${BASE_URL}/scan/delete`, {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ file_id: result.file_id })
  });
  console.log('File purged from storage.');
}
scanDocument();