Originality.ai

Documentation

Scan

Batch Scan

Scan Url

Credit Balance

Scan Results

Blank

Originality.ai API V1

Version 3

Originality.ai API Documentation and Guide

Production

Sandbox

<p class="slate-p " >Explore our guides and examples to integrate <a href="https://Originality.ai" target="_self">Originality.ai</a> into your workflows</p><p class="slate-p " ></p><p class="slate-p " ></p><div class="steps-widget" style="width:100%;
  	min-width:100%;"><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >1</h6><h3 class="slate-h3 " >First step</h3><p class="slate-p " ><a href="https://app.originality.ai/signup" target="_blank">Create </a>or <a href="https://app.originality.ai/login" target="_blank">Login </a>to <a href="https://Originality.ai" target="_self">Originality.ai</a> and subscribe to our <a href="https://originality.ai/pricing" target="_blank">Enterprise</a> level plan</p><p class="slate-p " ></p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >Create API Key</h3><p class="slate-p " >Create an api key for use here:<a href="https:// https://app.originality.ai/home/api-token-dashboard" target="_blank"> https://app.originality.ai/home/api-token-dashboard</a></p><p class="slate-p " ></p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >Prepare Requests</h3><p class="slate-p " >All requests must contain the following header</p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:100px;">Key</div><div style="width:100px;">Value</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >X-OAI-API-KEY</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >your-api-key</p></td></div></tr></tbody></table></div></div><p class="slate-p " ></p></div></div></div><p class="slate-p " ></p><p class="slate-p " ></p><h1 class="slate-h1 " >Important Information</h1><p class="slate-p " ></p><h3 class="slate-h3 " >Rate Limit</h3><p class="slate-p " >The rate limit for our api is 500 requests per minute. Your remaining limit for the current minute can be found by examining the response headers after a request has completed. In the event you have reached the upper limit, a 429 “too many requests” error will be returned by our system</p><p class="slate-p " ></p><h3 class="slate-h3 " >Auto Credit Top-up</h3><p class="slate-p " >By default, <a href="https://Originality.ai" target="_self">Originality.ai</a> accounts are set to automatically top up credits when they fall low. This means that if you&apos;ve exhausted your <a href="https://originality.ai" target="_self">originality.ai</a> credits while using the api, credits will be automatically purchased using your default payment method on file. This is to ensure smooth operating of your workflows. You can manage your top up settings anytime here: <a href="https://app.originality.ai/home/account#topup" target="_self">https://app.originality.ai/home/account#topup</a></p><p class="slate-p " >Tips to avoid unwanted credit card charges</p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div></div><colgroup ><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >a) Reduce request concurrency</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >b) Adjust Auto top up settings (disable, +/- threshold)</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >c) Manually purchase credits - <a href="https://app.originality.ai/home/credits/purchase" target="_blank">https://app.originality.ai/home/credits/purchase</a></p></td></div></tr></tbody></table></div></div><h1 class="slate-h1 " >Scan Features</h1><p class="slate-p " >This page outlines the scan features you can use to check your content</p><h2 class="slate-h2 " ></h2><h2 class="slate-h2 " ><a href="https://originality.ai/" target=""><strong class="slate-bold">AI Checker</strong></a></h2><p class="slate-p " ></p><p class="slate-p " >For the most accurate scoring provide plain text into the api when initiating a new scan</p><p class="slate-p " ></p><p class="slate-p " >Models</p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:100px;">Title</div><div style="width:100px;">Description</div><div style="width:100px;">Title</div><div style="width:100px;">Description</div></div><colgroup ><col style="width:initial"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Version</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >String for Scan Request</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Description</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Tags</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Lite - 1.0.0</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >“lite”</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Under 1% False Positive rate. Use when you want to allow some use of AI for editing. Best for academia.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Lightly AI-edited content is acceptable</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Turbo - 3.0.2</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >“turbo”</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Under 5% False Positive rate. most accurate AI detector that is very hard to bypass. Use when you want to be certain AI was not used. <a href="https://originality.ai/ai-content-detection-accuracy/" target="_self">Learn more</a>.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Effective on the latest LLMs including GPT-4o, ChatGPT, Gemini Pro, Claude 3 and popular open-source models such as Llama 3.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Multi-Language</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >“multilang”</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Our standard model that supports languages other than English.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Russian, Spanish, Turkish, Italian, French, German, Portuguese, Dutch, Chinese (Mandarin), Greek, Polish, Vietnamese, Japanese, Persian</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Lite - 1.0.2</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >“lite-102”</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Latest Beta Version of the Lite Model</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Lightly AI-edited content is acceptable</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Academic 0.0.5</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >“academic”</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Ideal for teachers and students</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ></p></td></div></tr></tbody></table></div></div><h2 class="slate-h2 " ></h2><h2 class="slate-h2 " ><a href="https://originality.ai/plagiarism-checker" target="_self"><strong class="slate-bold">Plagiarism Checker</strong></a></h2><p class="slate-p " >Use our plagiarism features to protect your reputation &amp; improve your content quality by accurately detecting plagiarism content. Our plagiarism feature uses advanced machine learning to accurately detect plagiarism. It is designed to detect complex forms of plagiarism such as patchwork, unintentional, mosaic plagiarism and more!</p><p class="slate-p " >When enabling this feature on a new scan request, it will extend the length of time it takes to get a response from the API. Depending on the size of content submitted, it could take up to 60 seconds to process. If you are experiencing timeouts when running a plagiarism check you can split the content into multiple chunks and run them separately.</p><h2 class="slate-h2 " ></h2><h2 class="slate-h2 " ><a href="https://originality.ai/readability-checker" target="_self"><strong class="slate-bold">Readability Checker</strong></a></h2><p class="slate-p " >Use our readability feature to help ensure that your writing isn&apos;t too complex for your readers. By giving you an approximate grade level / score, you can ensure that your content is easily understood by your target audience and they&apos;re getting the most value possible out of the information you&apos;re sharing</p><h2 class="slate-h2 " ></h2><h2 class="slate-h2 " ><strong class="slate-bold">Grammar &amp; Spelling Checker</strong></h2><p class="slate-p " >Use our Grammar checker to check for any grammatical, spelling, and punctuation errors. Regardless of what you are writing, you have to make sure your piece is without any mistakes.</p><p class="slate-p " ></p><p class="slate-p " ><strong class="slate-bold">Fact Checker:</strong>
Our Automated Fact-Checker verifies your content in real time, flagging potential inaccuracies and providing clear justifications with trusted source links. Designed for publishers, agencies, and writers, it helps you maintain impeccable credibility in an era of evolving AI-generated text.</p><p class="slate-p " >
<strong class="slate-bold">SEO Content Optimization:</strong>
Our Content Optimizer delivers a precise, cheat-resistant quality score that predicts how well your content will rank on Google. Use it to assess your page’s SEO performance and access actionable recommendations that boost overall content quality.</p><p class="slate-p " ></p>

Explore our guides and examples to integrate 

The rate limit for our api is 500 requests per minute. Your remaining limit for the current minute can be found by examining the response headers after a request has completed. In the event you have reached the upper limit, a 429 “too many requests” error will be returned by our system

 accounts are set to automatically top up credits when they fall low. This means that if you've exhausted your 

 credits while using the api, credits will be automatically purchased using your default payment method on file. This is to ensure smooth operating of your workflows. You can manage your top up settings anytime here: 

Tips to avoid unwanted credit card charges

Title

This page outlines the scan features you can use to check your content

For the most accurate scoring provide plain text into the api when initiating a new scan

Description

Use our plagiarism features to protect your reputation & improve your content quality by accurately detecting plagiarism content. Our plagiarism feature uses advanced machine learning to accurately detect plagiarism. It is designed to detect complex forms of plagiarism such as patchwork, unintentional, mosaic plagiarism and more!

When enabling this feature on a new scan request, it will extend the length of time it takes to get a response from the API. Depending on the size of content submitted, it could take up to 60 seconds to process. If you are experiencing timeouts when running a plagiarism check you can split the content into multiple chunks and run them separately.

Use our readability feature to help ensure that your writing isn't too complex for your readers. By giving you an approximate grade level / score, you can ensure that your content is easily understood by your target audience and they're getting the most value possible out of the information you're sharing

Use our Grammar checker to check for any grammatical, spelling, and punctuation errors. Regardless of what you are writing, you have to make sure your piece is without any mistakes.


Our Automated Fact-Checker verifies your content in real time, flagging potential inaccuracies and providing clear justifications with trusted source links. Designed for publishers, agencies, and writers, it helps you maintain impeccable credibility in an era of evolving AI-generated text.


Our Content Optimizer delivers a precise, cheat-resistant quality score that predicts how well your content will rank on Google. Use it to assess your page’s SEO performance and access actionable recommendations that boost overall content quality.

Originality.ai API V3 Documentation and Instructions

<p class="slate-p " >Run a new scan on your content. Check for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling and Content Optimization </p><p class="slate-p " ></p>

Run a new scan on your content. Check for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling and Content Optimization 

title

check_ai

check_plagiarism

check_facts

check_readability

check_grammar

check_contentOptimizer

Keyword or phrase you want your content to rank for

optimizerQuery

"United States" - only the United States is supported at this time

optimizerCountry

optimizerDevice

optional - enter the url of the website where this content will be published. This helps our AI analyze keyword relevance, back links, and content performance which can improve ranking predictions

optimizerPublishingDomain

Set to false if you don't want your scan stored for access later. Warning - setting this to false will prevent you from viewing the results again

storeScan

excludedUrls

what AI model to use for AI detection. "lite", "turbo", "multilang"

aiModelVersion

content

X-OAI-API-KEY

results

How to Run an Originality.ai API Scan

<p class="slate-p " >Scan multiple pieces of content for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling</p><p class="slate-p " ></p>

Scan multiple pieces of content for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling

batches

How to Run a Batch Scan With the Originality.ai API

<p class="slate-p " >Run a new scan on a url. Check for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling and Content Optimization </p><p class="slate-p " ></p><p class="slate-p " ></p>

Run a new scan on a url. Check for AI Detection, Plagiarism, Factual Claims, Readability, Grammar/Spelling and Content Optimization 

excludedUrl

aiModel

Originality.ai API Scan URL Instructions

<p class="slate-p " >Use this endpoint to return the number of base &amp; subscription credits remaining. You can purchase more within the application <a href="https://app.originality.ai/home/account#purchase" target="_blank">here</a></p><p class="slate-p " ></p><p class="slate-p " ></p>

Use this endpoint to return the number of base & subscription credits remaining. You can purchase more within the application 

credits

subscriptionCredits

Originality.ai Credit Balance Instructions via API

<p class="slate-p " >Use this endpoint to fetch the results of a single scan by id</p><p class="slate-p " >Text/link results in the example below are formatted with symbols converted to character code. Results returned by the actual api are plain text</p><p class="slate-p " ></p><p class="slate-p " ></p>

Use this endpoint to fetch the results of a single scan by id

Text/link results in the example below are formatted with symbols converted to character code. Results returned by the actual api are plain text

Sections