Documentation for the API of candy-content.com

API is available at: https://candy-content.com/api/check-uniqueness/

Request type: POST
Requests are made in JSON format
Responses are returned in JSON format

Currently, only one API method is available - text uniqueness check. All other actions like balance check, account recharge, and other tools are available only through the Telegram bot - http://t.me/JuniorSeoBot/

To use the API, you will need an api_key. You can get it through the bot in the section “My Account” -> API -> “My API Key”:

For any technical questions and support, contact the administrator http://t.me/sergei4e/

API Methods

1. /check-uniqueness/

Request Parameters

Required fields:
api_key - your API key,
text - text to check or URL of the page with http.

Optional fields:
precision - determines the quality and completeness of the check.
By default, it is set to “better”, the cost of such a check is 1 🍭 per 5000 characters.
You can set it to “best”, which may increase the quality of the check, the cost will be 2 🍭 per 5000 characters.
ignore_domain - the domain ignored during the check.

Request:

import time
import json
import requests
from pprint import pprint

api_url = "https://candy-content.com/api/check-uniqueness/"
api_key = "your_api_key"

text = """
In 1831, after moving from Vilno to St. Petersburg, landowner P. Engelhardt took Shevchenko with him[42],
and to eventually profit from the artistic works of his own "household artist",
he signed a contract and sent him to study for four years under the painter V. Shiryaev,
with whom Taras lived until 1838[43]. In Shiryaev's workshop, Shevchenko was surrounded by other talented young people,
like himself, from lower social strata - serfs or freedmen and townspeople who sought to better master the art of painting and become artists.[44]
Shiryaev treated his apprentices harshly; in his autobiography and the story "Artist", Shevchenko wrote
about him as a "greedy, rough, harsh, and despotic man". Typically, Shiryaev signed contracts
for eight years: five of which were allocated for learning, and during the next three years the apprentice
had to "repay the master for the training" by working for him.
"""

data = {
  "api_key": api_key,
  "text": text
}

t1 = time.time()
response = requests.post(api_url, data=data)
t2 = time.time()

print(f"Working time: {round(t2-t1, 2)} sec")
pprint(response.json())

Response:

api_examples % python check_uniqueness.py

Working time: 38.19 sec

{
    'response': {
       'current_balance': 31,
        'matches_sites': {
           'https://naurok.com.ua/prezentaciya-do-biografi-t-shevchenka-308682.html': '30%',
            'https://nmetau.edu.ua/ua/mlibrary/i14/p-3/e4123': '33%',
            'https://prezi.com/p/98fxlx3_kxbr/presentation/': '67%',
            'https://uk.tgstat.com/channel/nA9e4itD2c42NjUy/2198': '44%',
            'https://www.kamenyar.com.ua/kamenyarivski-zustrichi/vydatni-ukraintsi/taras-shevchenko.html': '75%',
            'https://www.mindomo.com/mindmap/mind-map-a3f16e9b4303923c7faa86f7a244fa84': '33%',
            'https://www.wikidata.uk-ua.nina.az/%D0%A2._%D0%A8%D0%B5%D0%B2%D1%87%D0%B5%D0%BD%D0%BA%D0%BE.html': '76%'
        },
       'old_balance': 34,
       'price': 3,
       'uniqueness_text': '0%'
    }
}

Error Messages

Text sent for verification is too short

{ "response": "Too small text" }

User is not authorized (likely an incorrect api_key)

{ "response": 401 }

Invalid JSON in the API request

{ "response": "JSONDecodeError invalid control character at: line 3 column 172 (char 226)" }