SmallSEOTools API

https://smallseotools.com/api-documentation/
Admin
SmallSEOTools API provides programmatic plagiarism detection and account status verification to...
Tokens:5,887
Snippets:31
Trust Score:10
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### CallBack URL - cURL

Source: https://smallseotools.com/api-documentation

Curl example for making a GET request to the callback URL with hash and key parameters from the first response.

```bash
curl -X GET https://pro.smallseotools.com/api/query-footprint/{hash}/{key}
```

--------------------------------

### CallBack URL - Response

Source: https://smallseotools.com/api-documentation

Example JSON response from the callback URL, showing recall, hash, and key fields.

```json
{
    "recall":  true, 
    "hash" : "04eb63e8b9588ac40a0b4515900eb6f7", 
    "key" :  2, 
}
```

--------------------------------

### Check Account Status - Python

Source: https://smallseotools.com/api-documentation

Python example using the requests library to POST to the account status endpoint with a token payload.

```python
import requests

url = "https://pro.smallseotools.com/api/info"
payload={'token': 'API_TOKEN'}
headers = {}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
```

--------------------------------

### Check Account Status - cURL

Source: https://smallseotools.com/api-documentation

Curl example for checking your account status. Sends a POST request to https://pro.smallseotools.com/api/info with a token parameter.

```bash
curl -X POST https://pro.smallseotools.com/api/info   
-d "token=YOUR_TOKEN"
```

--------------------------------

### Check Plagiarism - Response

Source: https://smallseotools.com/api-documentation

Example JSON response from the plagiarism check endpoint, showing recall, totalQueries, key, and hash fields.

```json
{
    "recall":  true, 
    "totalQueries" :  5, 
    "key" :  1, 
    "hash" :  "04eb63e8b9588ac40a0b4515900eb6f7"  
}
```

--------------------------------

### Check Plagiarism - Python

Source: https://smallseotools.com/api-documentation

Python example using the requests library to POST to the plagiarism check endpoint with token, exclude_urls, data, url, and rephrased parameters.

```python
import requests

url = "https://pro.smallseotools.com/api/checkplag"

payload={'token': 'API_TOKEN','exclude_urls': '["EXCLUDE URL1","EXCLUDE URL2","EXCLUDE URL3"]',
'data': 'On the red table, there was a purple curtain. Underneath that was a silver cage.  Inside that cage there was a green teddy bear, with the number 43 written on its chest with a black permanent marker. Its eyes were as green as envy.', 'url':'PAGE_URL', 'rephrased':true}
headers = {}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
```

--------------------------------

### Check Account Status - Response

Source: https://smallseotools.com/api-documentation

Example JSON response from the account status endpoint, showing account name, total words, used words, and account status.

```json
{
    "name":  "SST", 
    "total_words" :   1500, 
    "used_words" :    1000, 
    "account_status" :  "active"  
}
```

--------------------------------

### Check Account Status - NodeJS

Source: https://smallseotools.com/api-documentation

Node.js example using the https module to POST to the account status endpoint. The request body includes a token.

```javascript
var http = require("https");
var options = {
"method": "POST",
"hostname": [
    "pro.smallseotools",
    "com"
],
"path": [
    "api",
    "info"
]
};

var req = http.request(options, function (res) {
var chunks = [];

res.on("data", function (chunk) {
    chunks.push(chunk);
});

res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
});
});

req.write("Content-Disposition: form-data; name=\"token\"
YOUR_TOKEN");
req.end();
```

--------------------------------

### Check Plagiarism - cURL

Source: https://smallseotools.com/api-documentation

Curl example for checking plagiarism. Sends a POST request to https://pro.smallseotools.com/api/checkplag with token, exclude_urls, data, url, and rephrased parameters.

```bash
curl -X POST https://pro.smallseotools.com/api/checkplag   
-d "token=YOUR_TOKEN"   
-d "exclude_urls=["EXCLUDE URL1","EXCLUDE URL2","EXCLUDE URL3"]"   
-d "data = On the red table, there was a purple curtain. Underneath that was a silver cage. Inside that cage there was a green teddy bear, with the number 43 written on its chest with a black permanent marker. Its eyes were as green as envy."  
-d "url = PAGE_URL"  
-d "rephrased=true"
```

--------------------------------

### GET /api/query-footprint/{hash}/{key}

Source: https://smallseotools.com/api-documentation

Callback endpoint to retrieve subsequent plagiarism results. It uses the hash and key from the previous response and should be repeated until `recall` is false.

```APIDOC
## [GET] https://pro.smallseotools.com/api/query-footprint/{hash}/{key}

### Description
Retrieves the next set of plagiarism results using the hash and key from the initial response. Repeat this request with updated parameters until `recall` is false.

### Method
GET

### Endpoint
https://pro.smallseotools.com/api/query-footprint/{hash}/{key}

### Parameters
#### Path Parameters
- **hash** (string) - Required - The hash value from the previous response.
- **key** (integer) - Required - The key value from the previous response.

### Request Example
```
curl -X GET https://pro.smallseotools.com/api/query-footprint/{hash}/{key}
```

### Response
#### Success Response (200)
- **recall** (boolean) - Indicates if more queries are needed.
- **hash** (string) - The hash value for the next query.
- **key** (integer) - The key value for the next query.

#### Response Example
```
{
    "recall":  true, 
    "hash" : "04eb63e8b9588ac40a0b4515900eb6f7", 
    "key" :  2, 
}
```
```

--------------------------------

### Check Plagiarism - NodeJS

Source: https://smallseotools.com/api-documentation

Node.js example using the http module to POST to the plagiarism check endpoint. The request body includes token, exclude_urls, rephrased, data, and url parameters.

```javascript
var http = require("http");

var options = {
"method": "POST",
"hostname": [
    "pro.smallseotools",
    "com"
],
"path": [
    "api",
    "checkplag"
]
};

var req = http.request(options, function (res) {
var chunks = [];

res.on("data", function (chunk) {
    chunks.push(chunk);
});

res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
});
});

req.write("Content-Disposition: form-data; name='token'
YOUR_TOKEN
name='exclude_urls' ["EXCLUDE URL1","EXCLUDE URL2","EXCLUDE URL3"]
name='rephrased' true
name='data'
On the red table, there was a purple curtain. Underneath that was a silver cage.  Inside that cage there was a green teddy bear, with the number 43 written on its chest with a black permanent marker. Its eyes were as green as envy.
name='url' PAGE_URL
");
req.end();
```

--------------------------------

### Plagiarism Checker API Response Format

Source: https://smallseotools.com/api-documentation

Example response format for the plagiarism checker API. Shows the top-level fields recall, totalQueries, plagPercent, uniquePercent, rephrasedPercent, exactMatchedPercent, and a details array. Each detail object includes query, error, unique, and optionally rephrased and webs with title, url, and des fields.

```json
{
    "recall":  false, 
    "totalQueries" :  5, 
    "plagPercent" :  20, 
    "uniquePercent" :  80, 
    "rephrasedPercent": 0,
    "exactMatchedPercent": 20,
    "details" :    [
        {
            "query": "On the red table, there was a purple curtain.",
            "error": 0,
            "unique": "true"
        },
        {
            "query": "Underneath that was a silver cage.",
            "error": 0,
            "unique": "true"
        },
        {
            "query": "Inside that cage there was a green teddy bear",
            "error": 0,
            "unique": "true"
        },
        {
            "query": "The first of four orbital test flights occurred in 1981 leading to operational flights beginning in 1982.",
            "error": 0,
            "rephrased": "true",
            "unique": "false",
            "webs": [
                {
                    "title": "Examples for “orbital test flight” and how to use it - Nyanglish",
                    "url": "http://nyanglish.com/orbital-test-flight",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982. they were used on a total of 135 missions from 1981 to 2011, launched from the kennedy space center (ksc) in florida."
                },
                {
                    "title": "Space Shuttle - Wikipedia",
                    "url": "https://en.m.wikipedia.org/wiki/Space_Shuttle",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982, all launched from the kennedy space center, florida.first operational flight of the space shuttle, first mission to carry four astronauts; sts-5. april 4, 1983. challenger."
                },
                {
                    "title": "Advanced Crew Escape Suit - WikiVisually",
                    "url": "https://wikivisually.com/lang-tr/wiki/Advanced_Crew_Escape_Suit",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982, all launched from the kennedy space center, florida. the system was retired from service in 2011 after 135 missions..."
                },
                {
                    "title": "Space Shuttle Launch Jigsaw Puzzle",
                    "url": "https://www.DailyJigsawPuzzles.net/plane-jigsaws/space-shuttle-launch_616.html",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982. it was used on a total of 135 missions from 1981 to 2011, launched from the kennedy space center (ksc) in florida. he first orbiter, enterprise..."
                },
                {
                    "title": "STS/Space Shuttle | Maxwell Hunter",
                    "url": "http://www.maxwellhunter.com/projects/space-shuttle",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982. they were used on a total of 135 missions from 1981 to 2011, launched from the kennedy space center (ksc) in florida."
                },
                {
                    "title": "Мягкая посадка - WikiVisually",
                    "url": "https://wikivisually.com/lang-ru/wiki/%D0%9C%D1%8F%D0%B3%D0%BA%D0%B0%D1%8F_%D0%BF%D0%BE%D1%81%D0%B0%D0%B4%D0%BA%D0%B0",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982, all launched from the kennedy space center, florida. the system was retired from service in 2011 after 135 missions..."
                },
                {
                    "title": "GEOSPACE:",
                    "url": "https://www.csun.edu/~mb304231/",
                    "des": "the first of four orbital test flights occurred in 1981 leading to operational flights beginning in 1982. the system is scheduled to be retired from service in 2011 after 135 launches. major missions have included launching numerous satellites and interplanetary probes..."
                },
                {
                    "title": "Space Shuttle Landing On The Moon - ma",
                    "url": "http://machicon-akihabara.info/2017simage-space-shuttle-landing-on-the-moon.awp",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982. in addition to the prototype whose completion was cancelled, five complete shuttle systems were built and used on a total of 135 missions from 1981 to 2011..."
                },
                {
                    "title": "Space Shuttle on Launchpad Minecraft Project",
                    "url": "https://www.planetminecraft.com/project/space-shuttle-on-launchpad/",
                    "des": "the first of four orbital test flights occurred in 1981, leading to operational flights beginning in 1982. in addition to the prototype whose completion was cancelled, five complete shuttle systems were built and used on a total of 135 missions from 1981 to 2011..."
                }
            ]
        }
    ]
}
```

--------------------------------

### POST /api/info

Source: https://smallseotools.com/api-documentation

Endpoint to check the account status of the user. It requires the API token in the request body and returns account details such as name, word usage, and status.

```APIDOC
## [POST] https://pro.smallseotools.com/api/info

### Description
Checks the account status of the user by providing the API token.

### Method
POST

### Endpoint
https://pro.smallseotools.com/api/info

### Parameters
#### Request Body
- **token** (string) - Required - Your API token.

### Request Example
```
curl -X POST https://pro.smallseotools.com/api/info   
-d "token=YOUR_TOKEN"
```

### Response
#### Success Response (200)
- **name** (string) - The name of the API user.
- **total_words** (integer) - Total words allocated to the account.
- **used_words** (integer) - Words used so far.
- **account_status** (string) - Status of the account (e.g., "active").

#### Response Example
```
{
    "name":  "SST", 
    "total_words" :   1500, 
    "used_words" :    1000, 
    "account_status" :  "active"  
}
```
```

--------------------------------

### POST /api/checkplag

Source: https://smallseotools.com/api-documentation

Endpoint to check plagiarism for content or a URL. It accepts the API token, optional exclude URLs, content or URL, and an optional rephrased flag. Returns query information for subsequent callback requests.

```APIDOC
## [POST] https://pro.smallseotools.com/api/checkplag

### Description
Checks plagiarism for an article, post, or document. Supports URL checks and rephrased sentence detection.

### Method
POST

### Endpoint
https://pro.smallseotools.com/api/checkplag

### Parameters
#### Request Body
- **token** (string) - Required - Your API token.
- **exclude_urls** (array of strings) - Optional - List of URLs to exclude from the plagiarism check.
- **data** (string) - Optional - The content to check for plagiarism. Either `data` or `url` is required.
- **url** (string) - Optional - The page URL to check for plagiarism. Either `data` or `url` is required.
- **rephrased** (boolean) - Optional - Set to `true` to enable rephrased sentence detection. Default is `false`.

### Request Example
```
curl -X POST https://pro.smallseotools.com/api/checkplag   
-d "token=YOUR_TOKEN"   
-d "exclude_urls=[\"EXCLUDE URL1\",\"EXCLUDE URL2\",\"EXCLUDE URL3\"]"   
-d "data = On the red table, there was a purple curtain. Underneath that was a silver cage. Inside that cage there was a green teddy bear, with the number 43 written on its chest with a black permanent marker. Its eyes were as green as envy."  
-d "url = PAGE_URL"  
-d "rephrased=true"   
```

### Response
#### Success Response (200)
- **recall** (boolean) - Indicates if more queries are needed.
- **totalQueries** (integer) - Total number of queries.
- **key** (integer) - The current query key.
- **hash** (string) - A hash value for the query.
- **rephrasedPercent** (number) - Percentage of content identified as rephrased (only when `rephrased` is true).
- **exactMatchedPercent** (number) - Percentage of content matched exactly (only when `rephrased` is true).
- **details** (array) - Array of sentence details, each with `unique` flag and optionally `rephrased` flag.

#### Response Example
```
{
    "recall":  true, 
    "totalQueries" :  5, 
    "key" :  1, 
    "hash" :  "04eb63e8b9588ac40a0b4515900eb6f7"  
}
```
```
Tokens:
Raw