curl --request POST \
  --url https://api.copyleaks.com/v1/image-plagiarism-detector/my-scan-1/check \
  --header 'Authorization: Bearer YOUR_LOGIN_TOKEN' \
  --form 'image=@/path/to/my-photo.jpg' \
  --form 'filename=my-photo.jpg' \
  --form 'sandbox=false'

from copyleaks.copyleaks import Copyleaks
from copyleaks.models.ImagePlagiarism.Requests.CopyleaksImagePlagiarismRequestModel import CopyleaksImagePlagiarismRequestModel

auth_token = Copyleaks.login("[email protected]", "YOUR_API_KEY")

with open('my-photo.jpg', 'rb') as image_file:
    request = CopyleaksImagePlagiarismRequestModel(image=image_file, file_name='my-photo.jpg', sandbox=False)
    response = Copyleaks.ImagePlagiarismClient.check(auth_token, 'my-scan-1', request)

score = response.matches.score
print(f"Total matches: {score.total_matches}")
print(f"Full matches: {score.full_matches}")
print(f"Partial matches: {score.partial_matches}")

const imageFile = document.getElementById('fileInput').files[0];
const formData = new FormData();

formData.append('image', imageFile);
formData.append('filename', imageFile.name);
formData.append('sandbox', 'false');

const response = await fetch(
  'https://api.copyleaks.com/v1/image-plagiarism-detector/my-scan-1/check',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer YOUR_LOGIN_TOKEN' },
    body: formData,
  }
);

const result = await response.json();
console.log('Total matches:', result.matches.score.totalMatches);
console.log('Matches:', result.matches.internet);

{
  "developerPayload": "my-custom-data",
  "scannedImage": {
    "scanId": "my-scan-1",
    "expectedCredits": 1,
    "actualCredits": 1,
    "creationTime": "2026-05-24T10:00:00Z",
    "width": 1920,
    "height": 1080,
    "filename": "my-photo.jpg"
  },
  "matches": {
    "internet": [
      {
        "url": "https://example.com/images/photo.jpg",
        "matchType": 0,
        "webPages": [
          { "url": "https://example.com/blog/my-post" },
          { "url": "https://example.org/news/article" }
        ]
      },
      {
        "url": "https://example.com/thumbs/photo-thumb.jpg",
        "matchType": 1,
        "webPages": [
          { "url": "https://example.org/gallery" }
        ]
      },
      {
        "url": "https://example.org/gallery/photo-sm.jpg",
        "matchType": 1
      }
    ],
    "score": {
      "totalMatches": 3,
      "fullMatches": 1,
      "partialMatches": 2
    }
  }
}