Get started
-
Before you begin
Before you start, ensure you have the following:- An active Copyleaks account. If you don’t have one, sign up for free.
- You can find your API key on the API Dashboard.
-
Installation
Choose your preferred method for making API calls.HTTP needs no installation - call the API with any standard HTTP client, or import our Postman collection for a quicker start. -
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 theAuthorization: Bearer <TOKEN>header. This token remains valid for 48 hours.ResponseSave this token. It is valid for 48 hours and can be reused for subsequent API calls. -
Submit image for plagiarism check
Use the Image Plagiarism Detection Endpoint to submit an image usingmultipart/form-data.Image Requirements
- File size: Less than 20MB
- Max resolution: 75 megapixels (width × height ≤ 75,000,000)
- Formats: JPG, JPEG, PNG, GIF, BMP, WebP, RAW, ICO
- HTTP
- cURL
- Python
- JavaScript
- Java
-
Interpreting the response
A successful response contains scan metadata and amatchesobject with:matches.internet- All matching images found on the web. Each entry has aurl, amatchType, and an optionalwebPageslist:0- Full match: Exact or near-exact copy of the submitted image.1- Partial match: Cropped, resized, recolored, or otherwise modified version.webPages- The web pages where the image was found (each with aurl). Omitted when the image was not located on any page. The same image URL never appears more than once.
matches.score- A summary withtotalMatches,fullMatches, andpartialMatchescounts.scannedImage- Metadata about the submitted image: scan ID, credits charged, dimensions, filename, and creation time.
An emptymatches.internetarray with all-zero scores means no matching content was found on the web. -
Summary
You have successfully checked your image for plagiarism. You can now use the match URLs in your application to alert users, file takedown requests, or record provenance data.
Next steps
API Reference
Full API reference for the Image Plagiarism Detection endpoint.
Image Plagiarism Response
Detailed breakdown of every field in the Image Plagiarism Detection response.

