/v3/education/submit/url/{scanId}
Scan URLs to see where it has been used before and check its originality. Using submit-url you can scan online content by submitting a URL, for plagiarism and identify infringed content in supported formats.
For integration testing purposes, use sandbox mode - for free.
Request
URL Parameters
scanId
REQUIREDWe 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.
Allowed characters are [a-zA-Z0-9]
and the following symobols: [email protected]$^&-+%=_(){}<>';:/.",~`|
Body Parameters
url
REQUIREDhttp://example.com
properties.webhooks.status
REQUIRED 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
.
Read more about webhooks.
https://yoursite.com/webhook/{STATUS}
Request Example
PUT https://api.copyleaks.com/v3/education/submit/url/my-custom-id
Content-Type: application/json;
Authorization: Bearer YOUR-LOGIN-TOKEN;
{
"url": "http://example.com",
"properties": {
"action": 0,
"includeHtml": false,
"developerPayload": "Custom developer payload",
"sandbox": true,
"expiration": 480,
"author": {
"id": "Author id"
},
"webhooks": {
"newResult": "https://yoursite.com/webhook/new-result",
"status": "https://yoursite.com/webhook/{STATUS}/my-custom-id"
},
"filters": {
"identicalEnabled": true,
"minorChangesEnabled": true,
"relatedMeaningEnabled": true,
"minCopiedWords": 10,
"safeSearch": false,
"domains": [
"www.example.com"
],
"domainsMode": 1
},
"scanning": {
"internet": true
},
"exclude": {
"quotes": false,
"titles": false,
"htmlTemplate": false
},
"sensitivityLevel": 3
}
}
Response
Codes
201
400
{ "properties.webhooks.status": [ "The field is required." ] }
401
Authorization has been denied for this request.
409
429
This method has a maximum call limit of 12 calls within 15 minutes.
Other resources:
- Performance ConsiderationsImportant! - 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.