The Copyleaks AI Detector API is a powerful tool to determine if a given text was written by a human or generated by an AI. The API is synchronous, meaning you get the results in the same API call. This guide will walk you through the process of submitting text for AI detection and understanding the results.

​
Get started

1

​
Before you begin

Before you start, ensure you have the following:
2

​
Installation

Choose your preferred method for making API calls.
# macOS
brew install curl

# Ubuntu/Debian
sudo apt-get install curl

# Windows - download from https://curl.se
HTTP needs no installation - call the API with any standard HTTP client, or import our Postman collection for a quicker start.
3

​
Login

To perform a scan, we first need to generate an access token. For that, we will use the login endpoint. The API key can be found on the Copyleaks API Dashboard.Upon successful authentication, you will receive a token that must be attached to subsequent API calls via the Authorization: Bearer <TOKEN> header. This token remains valid for 48 hours.
POST https://id.copyleaks.com/v3/account/login/api

Headers
Content-Type: application/json

Body
{
    "email": "[email protected]",
    "key": "00000000-0000-0000-0000-000000000000"
}
Response
{
    "access_token": "<ACCESS_TOKEN>",
    ".issued": "2025-07-31T10:19:40.0690015Z",
    ".expires": "2025-08-02T10:19:40.0690016Z"
}
Save this token. It is valid for 48 hours and can be reused for subsequent API calls.
4

​
Submit for analysis

Use the AI Text Detection Endpoint to send text for analysis. We suggest you provide a unique scanId for each submission.
For testing, set "sandbox": true. Sandbox mode is free and returns mock results.
POST https://api.copyleaks.com/v2/writer-detector/my-scan-1/check

Headers
Authorization: Bearer <YOUR_AUTH_TOKEN>
Content-Type: application/json

Body
{
  "text": "Lions are social animals, living in groups called prides, typically consisting of several females, their offspring, and a few males. Female lions are the primary hunters, working together to catch prey. Lions are known for their strength, teamwork, and complex social structures.",
  "sandbox": true
}
5

​
Interpreting the response

For a complete breakdown of the response structure, see the AI Detection Response documentation.
6

​
Summary

You have successfully submitted text for AI detection. You can now use the JSON response in your application to take further action based on the findings.

​
Frequently asked questions

Yes. You send text to the check endpoint and receive the detection results in the same API call, with no webhook required.
POST https://api.copyleaks.com/v2/writer-detector/{scanId}/check, with the text to analyze in the request body.
Yes. Set "sandbox": true in the request. Sandbox mode is free and returns mock results so you can build the integration before going live.
A per-section classification (human or AI) and an overall human-versus-AI summary. See the AI Detection Response reference for the full structure.
This endpoint analyzes raw text synchronously. To scan files such as PDF or DOCX, use the asynchronous authenticity flow in Detect AI-Generated Content in Documents.

​
Next steps

API Reference

Explore the full API reference for the AI Detection endpoint.

AI Logic

Learn how to use AI logic can help you interpret the results of AI text detection.

Accuracy & 3rd Party Evaluations

Discover how Copyleaks AI Detector maintains top accuracy in third-party evaluations.