Copyleaks is designed for scalability and high performance, handling large workloads efficiently. To get the best results from your integration, follow these best practices to optimize speed, reduce bottlenecks, and maximize efficiency. This guide covers best practices for text and document scanning using the Authenticity, Grammar Checker, Text Moderation and AI Text Detector APIs. For image-specific optimization, see the Image Detection Best Practices guide.

​
Use Network Data Compression

Transmitting large amounts of data over the internet slows down performance. Compressing data can reduce payload size by up to 70%, speeding up processing times.

​
Enable Request Compression

Compress the data before sending it to Copyleaks and add this header: 
Content-Encoding: gzip
This is especially useful when submitting large files.

​
Enable Response Compression

To receive compressed responses from Copyleaks, include this header in your request: 
Accept-Encoding: gzip
This ensures faster data transfer between your system and Copyleaks.

​
Disable Unused Features

Copyleaks offers many configurable features, but enabling unnecessary ones can slow down scans. Only enable what you need. Some features to disable if not needed:
FeatureDescriptionRecommendation
properties.includeHtmlIncludes results in HTML formatDisable if plain text is enough.
properties.pdf.createGenerates a PDF reportTurn off if you don’t need a PDF.
properties.expirationDefines how long scan data is storedUse 7 days or less for optimal speed.
properties.filtersNarrows search resultsCustomize filters to improve scan efficiency.
Check the Authenticity API methods for the full list of features you can toggle.

​
Submit Scans at an Optimal Rate

Copyleaks runs on cloud infrastructure, dynamically scaling resources based on demand. However, submitting too many requests at once can reduce efficiency.

​
Avoid Overloading the System

  • Instead of submitting all documents at once, send them gradually at a controlled rate (N calls per second).
  • If handling large volumes (e.g., 1M+ files), adjust to the maximum allowed rate limit (see Rate Limit Policy).

​
Prevent Slow Start Issues

  • Don’t flood the system with a sudden burst of requests.
  • Instead, start with a low rate and gradually increase to maintain stable performance.
Custom plans are available for large-scale users who need higher limits. Contact [email protected] to discuss options.

​
Adjust Sensitivity for Speed vs. Accuracy

Copyleaks supports different sensitivity levels, balancing speed and comprehensiveness based on your needs. Set the properties.sensitivityLevel value based on priority:
LevelFocusBest For
1SpeedQuicker scans, less comprehensive.
3 (default)BalancedRecommended for most use cases.
5ComprehensiveDeep analysis, high accuracy.
We recommend level 3 for most users, but feel free to adjust as needed.

​
Reuse Your Authentication Token

Each JWT token generated during login is valid for 48 hours.
Avoid unnecessary login calls, reuse your token for multiple requests within its validity period.
For more information on obtaining a new token, refer to the Login API.

​
Next Steps

Image Detection Best Practices

Learn optimization strategies specific to AI Image Detection API.

Authenticity API Overview

Explore the full list of features and options available for configuring your scans.

Technical Specifications

Understand the rate limit policy and other technical specifications for optimal API usage.

Login API

Learn how to obtain and manage your authentication token for API access.