POST
Search the web for copies of an image. Returns a list of full matches (exact or near-exact copies) and partial matches (cropped, resized, or modified versions), each with the web pages where the image was found - all in a single synchronous API call.
Authentication Required. You need to login with a user and API key in order to access this method. Add this HTTP header to your request:Authorization: Bearer <Your-Login-Token>
Image Plagiarism Detection has a rate limit of 1,800 requests per 15 minutes per user. If exceeded, requests will be rejected with a 429 status code until the rate limit window resets.

Request

Path Parameters

string
required
A unique scan ID provided by you. We recommend you use the same ID in your database to represent the scan. Using the same ID for the same file helps avoid duplicate scans caused by network issues. Learn more about the criteria for creating a Scan ID.>= 3 characters <= 36 characters

Supported Content Type

Submit images using multipart/form-data. Headers:

Body Parameters

file
required
Binary image file to check for plagiarism.Requirements:
  • File size: Less than 20MB
  • Max resolution: 75 megapixels (width × height ≤ 75,000,000)
  • Formats: JPG, JPEG, PNG, GIF, BMP, WebP, RAW, ICO
string
required
The name of the image file including its extension.Requirements:
  • Allowed extensions: .jpg, .jpeg, .png, .gif, .bmp, .webp, .ico
  • <= 255 characters
Example: "my-photo.jpg"
boolean
default:"false"
Use sandbox mode to test your integration without consuming credits. Returns mock results.
string
An optional custom string you can attach to the request. It is echoed back unchanged in the response under developerPayload. Useful for correlating results with your own records.

Responses

200 OK The image was successfully analyzed. See the Image Plagiarism Response for the full response structure.