PUT

/v3/businesses/submit/file/{scanId}

Scan files to find where the content has been used elsewhere and check its originality. Using submit-file you can scan various file types for plagiarism and identify copied content. See supported formats.

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>

Not sure how to generate your login token? Read here.

For integration testing purposes, use sandbox mode - for free.

Request

URL Parameters

Name

Description

scanId REQUIRED

A unique scan id provided by you.

We recommend you use the same id in your database to represent the scan in the Copyleaks database. This will help you to debug incidents.

Using the same ID for the same file will help you to avoid network problems that may lead to multiple scans for the same file.

String

Length: 3-36 characters.

Allowed characters are [a-zA-Z0-9] and the following symobols: [email protected]$^&-+%=_(){}<>';:/.",~`|

Body Parameters

Name

Description

base64 REQUIRED

A base64 data string of a file. If you would like to scan plain text, encode it as base64 and submit it.

String

Example: aGVsbG8gd29ybGQ=

filename REQUIRED

The name of the file as it will appear in the Copyleaks scan report Make sure to include the right extension for your filetype.

String

Example: Myfile.pdf Max length: 255 characters.

properties.webhooks.status REQUIRED

This webhook event is triggered once the scan status changes.

Use the special token {STATUS} to track the current scan status. This special token will automatically be replaced by the Copyleaks servers with the optional values: completed, error, creditsChecked and indexed.

Request Example

RAW

cURL

Python

Node.js

PHP

PUT

https://api.copyleaks.com/v3/businesses/submit/file/my-custom-id

Headers

Body

base64: "SGVsbG8gd29ybGQh"

filename: "file.txt"

properties:

webhooks:

status: "https://yoursite.com/webhook/{STATUS}/my-custom-id"

Response

Codes

Status Code

Description

Example

201

The scan was Created.

400

Bad request.

{
  "properties.webhooks.status": [
    "The field is required."
  ]
}

401

Unauthorized

Authorization has been denied for this request.

409

A scan with the same Id already exists in the system.

429

Too many requests have been sent. The request has been rejected.

This may happen when sending too many scans in Sandbox mode.

Other resources:

Performance Considerations^Important! - How to improve your scan performance.

Exponential Backoff - Algorithm that helps applications define a retry strategy for consuming a network service.

Technical Specifications - See API's limits and supported formats.

Do you have a technical question?

Use stackoverflow.com to get help from our development team and other Copyleaks users.

Ask a Question