API Query Manual for contributors and developers

Cliparto's API Query accepts automatic queries to the database of Cliparto from other web servers or local software programs to provide the actual numbers of the current balance, the number of downloads, the number of images, current status of the image and other data.

Important Disclaimer: Automatic requests are allowed only through the API Query. Cliparto reserves the right to block access to the website in case of parsing certain pages.

How it works?

We have very simple algorithm for data output:
1. Your script sends a GET-request to our server at https://cliparto.com/apiq/
2. Our system checks the request.
3. If the request contains no error the requested information is displayed on the page of the request. Otherwise the error will be displayed.

Query parameters

Each request must contain the following parameters:

id - unique User ID (you can find it in the user settings section)

q - query type (list of accepted query types is shown in the following section)

ext - extra parameter (optional, depending on the query type)

md5 - MD5 hash of the request (accordingly to RFC 1321 - The MD5 Message-Digest Algorithm)

To calculate the MD5 hash, you need to make a string that contains all the query parameters as described below and pass it in as the value to your scripting languages MD5 function.
Example:

You can generate your API Code in the user settings section.

Example of PHP code to generate MD5 hash:

Example of query:

Query types

Restrictions

- No more than one request within 20 seconds
- The same query with the same parameters should not be repeated within one hour