Developer API & Integrations

import requests
import time

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

# 1. Submit Document
with open("thesis.docx", "rb") as f:
    response = requests.post(
        f"{BASE_URL}/scan/submit",
        headers=HEADERS,
        files={"file": f},
        data={"service_type": "Turnitin Plagiarism", "custom_id": "order_9812"}
    )
data = response.json()
print("Scan Queued:", data)
file_id = data["file_id"]

# 2. Poll Status until completed
while True:
    res = requests.get(f"{BASE_URL}/scan/status", headers=HEADERS, params={"file_id": file_id})
    res_data = res.json()
    status = res_data.get("status")
    print("Current status:", status)
    
    if status == "Completed":
        print(f"Similarity Score: {res_data.get('similarity_score')}%")
        print(f"AI Score: {res_data.get('ai_score')}%")
        
        # 3. Stream & save the PDF report directly to disk
        pdf_res = requests.get(f"{BASE_URL}/scan/download", headers=HEADERS, params={"file_id": file_id})
        with open("final_report.pdf", "wb") as pf:
            pf.write(pdf_res.content)
        print("Report successfully saved to final_report.pdf!")
        break
    elif status in ["Failed", "Rejected"]:
        print("Scan failed:", res_data.get("error_message"))
        break
    time.sleep(5)

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

// 1. Submit File
$ch = curl_init("$baseUrl/scan/submit");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('/path/to/thesis.docx'),
        'service_type' => 'Turnitin Plagiarism',
        'custom_id' => 'order_9812'
    ]
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

$fileId = $response['file_id'];
echo "Uploaded File ID: $fileId\n";

// 2. Download Report to Server
$fp = fopen('downloaded_report.pdf', 'w+');
$dlCh = curl_init("$baseUrl/scan/download?file_id=$fileId");
curl_setopt_array($dlCh, [
    CURLOPT_FILE => $fp,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $apiKey"]
]);
curl_exec($dlCh);
curl_close($dlCh);
fclose($fp);
echo "PDF report saved locally!\n";
?>

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

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

async function scanDocument() {
  const form = new FormData();
  form.append('file', fs.createReadStream('./thesis.docx'));
  form.append('service_type', 'Turnitin Plagiarism');
  form.append('custom_id', 'order_9812');

  // 1. Submit scan
  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('Result:', result);
  const fileId = result.file_id;

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