API Method backlinks_check

This method should be used only for mass backlinks check for a domain list. For other purposes use you could use other methods:

Call required GET params

  • method_name - should be 'spam_check',

  • auth_key - API key. To obtain a key please get an account here https://cleantalk.org/register?platform=api.

Example:

https://api.cleantalk.org/?method_name=backlinks_check&auth_key=123456&domain=example.com

API returns JSON string, for example:

{"data":{"example.com":{"appears":1,"frequency":"164","updated":"2016-08-05 07:15:51"}}}

 

Response explanation

  • data - array with results,
    • appears - marker which defines record existence in the database 0|1.
    • frequency - counts websites with backlinks in the record.
    • updated - last time a backlink was found.

 

Multiple records check

You can submit multiple records to test per 1 call, to do that use POST options:

data - string with records to check separated by ','.

Example:

wget -O- --post-data='data=example.com,example1.com' https://api.cleantalk.org/?method_name=backlinks_check\&auth_key=123456

Response:

{"data":{"example.com":{"appears":1,"frequency":"164","updated":"2016-08-05 07:15:51"},"example1.com":{"appears":0}}}

 

Restrictions

If you get calls limit, API returns error notice. Example:

{"error_message":"Calls limit exceeded.","error_no":10}

Current calls limit is 100 per 60 seconds.

 

If you get data elements limit in backlinks_check method, API returns error notice. Example:

{"error_message":"Recevied 1001 records to check, maximum 1000 records check perl call.","error_no":8}

Current data elements limit is 1000.

 

Recommended timeout is no more than 180 seconds.