This document provides all the necessary information you need for checking your text in your application.
For checking your text, you MUST:
For authorization, you MUST have a registered account with the service and have a special API token. For receiving an API token, you need to contact us. You MUST send your API token in all requests.
API returns 401 Unauthorized if you provide an invalid token. You MUST send your token in the header with the name X-API-TOKEN.
Example of an HTTP header:
X-API-TOKEN: vsMKX3179tjK3CqvhE228IDeMV-eBBER
The request has parameters:
curl "https://plagiarismcheck.org/api/v1/text" \ --request POST \ --header "X-API-TOKEN: cUwhcQU88K2cYn47aPCg-snWoSNNJwyW" \ --data "language=en" \ --data "text=an application programming interface (API) is a set of subroutine definitions, protocols, and tools for building application software. In general terms, it is a set of clearly defined methods of communication between various software components. A good API makes it easier to develop a computer program by providing all the building blocks, which are then put together by the programmer. An API may be for a web-based system, operating system, database system, computer hardware or software library. An API specification can take many forms, but often includes specifications for routines, data structures, object classes, variables or remote calls. POSIX, Microsoft Windows API, the C++ Standard Template Library and Java APIs are examples of different forms of APIs. Documentation for the API is usually provided to facilitate usage" \The Response:
{ "success": true, "data": { "text": { "id": 2, "filename": "an_application", "created_at": "1516279363000", "updated_at": "1516279364000", "submitted_at": "1516279364000", "is_deleted": false, "deleted_at": null, "state": 3, "language": "en", "pages": 1, "group_id": null, "user_id": 9, "report_id": null }, "charged": 0, "bonus_charged": 1 } }
This method receives an ID of the text and returns detailed information about the text. Here is a table with statuses:
ID | Name | Description |
2 | STATE_STORED | Text has been stored and waiting for a check. |
3 | STATE_SUBMITTED | Text has been stored and waiting for a check. |
4 | STATE_FAILED | Text has not been checked. An error happened. |
5 | STATE_CHECKED | Text has been successfully checked and you can receive the report. |
In example: "2" is the ID of text
Request:curl "https://plagiarismcheck.org/api/v1/text/2" \ -X GET \ -H "X-API-TOKEN: cUwhcQU88K2cYn47aPCg-snWoSNNJwyW" \Response:
{ "data": { "id": 2, "filename": "an_application", "created_at": "1516279363000", "updated_at": "1516279369000", "submitted_at": "1516279364000", "is_deleted": false, "deleted_at": null, "state": 5, "language": "en", "pages": 1, "group_id": null, "creator": { "id": 9, "name": "Test", "email": "test@example.com", "created_at": "1516279118000", "updated_at": "1516279118000", "is_blocked": false, "allowed_languages": [ "en" ], "balance": { "balance": 0, "bonus": 596, "hold": 0, "hold_bonus": 0 }, "avatar": null }, "report": { "id": 1, "created_at": "1516279369000", "source_count": 0, "percent": "0.00" } } }
This method receives an ID of the text and returns a detailed report. The text MUST be with status 5 (STATE_CHECKED). The report contains nodes, sources, and other information. Each node has text, a start position, an end position, and sources where the text was found. Each source has: content-type, percentage of plagiarism, and a URL. In example "2" is The ID of the text.
Request:curl "https://plagiarismcheck.org/api/v1/text/report/2" \ -X GET \ -H "X-API-TOKEN: cUwhcQU88K2cYn47aPCg-snWoSNNJwyW" \Response:
{ "data": { "report": { "id": 3952875, "created_at": "1513617036000", "source_count": 3, "percent": "100.00", "text_id": 3960269 }, "report_data": { "version": "1.1", "length": 2435, "created_at": "2017-12-18 11:10:35", "nodes": [ { "enabled": true, "start": 0, "end": 205, "text": "Because of its location on the crossroads between Europe and Asia, and its proximity to lucrative east-west trade routes, throughout history Tbilisi was a point of contention between various global powers. ", "sources": [ 0, 1, 2 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 1 }, { "source": 2, "cos": 0.66 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1, 2 ] }, { "enabled": true, "start": 206, "end": 327, "text": "The city\u0027s location to this day ensures its position as an important transit route for various energy and trade projects. ", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 1 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 328, "end": 486, "text": "Tbilisi\u0027s diverse history is reflected in its architecture, which is a mix of medieval, neoclassical, Beaux Arts, Art Nouveau, Stalinist and Modern structures.", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 0.7 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 487, "end": 692, "text": "Because of its location on the crossroads between Europe and Asia, and its proximity to lucrative east-west trade routes, throughout history Tbilisi was a point of contention between various global powers. ", "sources": [ 2 ], "sources_improved": [ { "source": 2, "cos": 0.66 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 2 ] }, { "enabled": true, "start": 693, "end": 814, "text": "The city\u0027s location to this day ensures its position as an important transit route for various energy and trade projects. ", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 1 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 815, "end": 973, "text": "Tbilisi\u0027s diverse history is reflected in its architecture, which is a mix of medieval, neoclassical, Beaux Arts, Art Nouveau, Stalinist and Modern structures.", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 0.7 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 974, "end": 1179, "text": "Because of its location on the crossroads between Europe and Asia, and its proximity to lucrative east-west trade routes, throughout history Tbilisi was a point of contention between various global powers. ", "sources": [ 2 ], "sources_improved": [ { "source": 2, "cos": 0.66 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 2 ] }, { "enabled": true, "start": 1180, "end": 1301, "text": "The city\u0027s location to this day ensures its position as an important transit route for various energy and trade projects. ", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 1 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 1302, "end": 1460, "text": "Tbilisi\u0027s diverse history is reflected in its architecture, which is a mix of medieval, neoclassical, Beaux Arts, Art Nouveau, Stalinist and Modern structures.", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 0.7 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 1461, "end": 1666, "text": "Because of its location on the crossroads between Europe and Asia, and its proximity to lucrative east-west trade routes, throughout history Tbilisi was a point of contention between various global powers. ", "sources": [ 2 ], "sources_improved": [ { "source": 2, "cos": 0.66 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 2 ] }, { "enabled": true, "start": 1667, "end": 1788, "text": "The city\u0027s location to this day ensures its position as an important transit route for various energy and trade projects. ", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 1 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 1789, "end": 1947, "text": "Tbilisi\u0027s diverse history is reflected in its architecture, which is a mix of medieval, neoclassical, Beaux Arts, Art Nouveau, Stalinist and Modern structures.", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 0.7 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 1948, "end": 2153, "text": "Because of its location on the crossroads between Europe and Asia, and its proximity to lucrative east-west trade routes, throughout history Tbilisi was a point of contention between various global powers. ", "sources": [ 2 ], "sources_improved": [ { "source": 2, "cos": 0.66 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 2 ] }, { "enabled": true, "start": 2154, "end": 2275, "text": "The city\u0027s location to this day ensures its position as an important transit route for various energy and trade projects. ", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 1 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] }, { "enabled": true, "start": 2276, "end": 2434, "text": "Tbilisi\u0027s diverse history is reflected in its architecture, which is a mix of medieval, neoclassical, Beaux Arts, Art Nouveau, Stalinist and Modern structures.", "sources": [ 0, 1 ], "sources_improved": [ { "source": 0, "cos": 1 }, { "source": 1, "cos": 0.7 } ], "references": [], "headers": [], "quotes": [], "destinations_clusters": [ 0, 1 ] } ], "indexes": [ { "id": 0, "db_id": 1, "name": "", "status": "success", "queries": 10, "type": "external" } ], "references": [], "header": [], "quotes": [], "sources": [ { "dst_pos_success": true, "content_type": "text\/html", "index": 0, "source": "https:\/\/en.wikipedia.org\/wiki\/Tbilisi", "length": 1611, "percent": 66.16, "link": { "name": "en.wikipedia.org", "urls": [ "https:\/\/en.wikipedia.org\/wiki\/Tbilisi" ] }, "tf_idf": false, "plagiarism_length": 1611, "plagiarism_percent": 66.16 }, { "dst_pos_success": true, "content_type": "text\/html", "index": 0, "source": "https:\/\/www.youtube.com\/watch?v=YU-db2NKMtY", "length": 1611, "percent": 66.16, "link": { "name": "www.youtube.com", "urls": [ "https:\/\/www.youtube.com\/watch?v=YU-db2NKMtY" ] }, "tf_idf": false, "plagiarism_length": 1611, "plagiarism_percent": 66.16 }, { "dst_pos_success": true, "content_type": "text\/html", "index": 0, "source": "https:\/\/www.facebook.com\/New-Georgia-Travel-agency-306643492874270\/", "length": 1030, "percent": 42.3, "link": { "name": "www.facebook.com", "urls": [ "https:\/\/www.facebook.com\/New-Georgia-Travel-agency-306643492874270\/" ] }, "tf_idf": false, "plagiarism_length": 1030, "plagiarism_percent": 42.3 } ], "sources_count": 3, "matched_length": 2435, "matched_percent": 100, "external_queries": 10, "destinations_clusters": [ { "source": 0, "id": 0, "offsets": [ { "start": 28510, "end": 28843, "cos": 1 }, { "start": 28844, "end": 28965, "cos": 1 }, { "start": 28966, "end": 29554, "cos": 1 }, { "start": 28844, "end": 28965, "cos": 1 }, { "start": 28966, "end": 29554, "cos": 1 }, { "start": 28844, "end": 28965, "cos": 1 }, { "start": 28966, "end": 29554, "cos": 1 }, { "start": 28844, "end": 28965, "cos": 1 }, { "start": 28966, "end": 29554, "cos": 1 }, { "start": 28844, "end": 28965, "cos": 1 }, { "start": 28966, "end": 29554, "cos": 1 } ] }, { "source": 1, "id": 1, "offsets": [ { "start": 87684, "end": 87889, "cos": 1 }, { "start": 87890, "end": 88011, "cos": 1 }, { "start": 88012, "end": 88180, "cos": 0.7 }, { "start": 87890, "end": 88011, "cos": 1 }, { "start": 88012, "end": 88180, "cos": 0.7 }, { "start": 87890, "end": 88011, "cos": 1 }, { "start": 88012, "end": 88180, "cos": 0.7 }, { "start": 87890, "end": 88011, "cos": 1 }, { "start": 88012, "end": 88180, "cos": 0.7 }, { "start": 87890, "end": 88011, "cos": 1 }, { "start": 88012, "end": 88180, "cos": 0.7 } ] }, { "source": 2, "id": 2, "offsets": [ { "start": 296896, "end": 297223, "cos": 0.66 }, { "start": 296896, "end": 297223, "cos": 0.66 }, { "start": 296896, "end": 297223, "cos": 0.66 }, { "start": 296896, "end": 297223, "cos": 0.66 }, { "start": 296896, "end": 297223, "cos": 0.66 } ] } ] } } }