Image Plagiarism Response

The Copyleaks Image Plagiarism Detection API returns a synchronous response containing scan metadata and a categorized list of web locations where the submitted image was found.

Response Properties

string

The custom string provided in the request, echoed back unchanged. null if not provided.

object

Metadata about the submitted image and the scan.

Show properties

string

The scan ID provided in the request path.

integer

The number of credits expected to be charged for this scan.

integer

The number of credits actually charged for this scan.

string

UTC timestamp of when the scan was created (ISO 8601). Example: "2026-05-24T10:00:00Z"

integer

Width of the submitted image in pixels.

integer

Height of the submitted image in pixels.

string

The filename provided in the request.

object

The detection results.

Show properties

array<object>

All matching images found on the web, with full matches ordered first, then partial matches. Each image URL appears at most once.

Show properties

string

The URL of the matching image.

integer

The type of match:

0 - Full: Exact or near-exact copy of the submitted image.
1 - Partial: Cropped, resized, recolored, or otherwise modified version.

array<object>

The web pages where this image was found. Omitted when the image was not located on any page.

Show properties

string

The URL of the web page containing the matching image.

object

A summary of match counts.

Show properties

integer

Total number of matching images found.

integer

Number of full matches (matchType 0).

integer

Number of partial matches (matchType 1).

Example Response

{
  "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
    }
  }
}

An empty matches.internet array with all-zero scores means no matching content was found on the web.

Reference

Actions

Data Types

Response Properties

Example Response

Next Steps

Image Plagiarism Detection Guide

Image Plagiarism Detection API Reference

​Response Properties

​Example Response

​Next Steps

Image Plagiarism Detection Guide

Image Plagiarism Detection API Reference

Response Properties

Example Response

Next Steps