API Search Manual for developersIf you provide on-demand online service or just need a gallery with images for your products, we have simple and effective solution! Include our images to your galleries and attract more customers.
Example of an image gallery you can get:
Please note, you have to buy the image only when you actually need it. No fee for the usage of our images at your website through the API Search.
How it works?
You can just use <iframe> tag to include the link with list of the images to your page. Or pop-up window.
Generate the link for iframe or pop-up using the form below:
Simple form:
Form with all parameters:
Please note you can also search for a certain image by Image ID. Just use the Image ID as keyword.
Note: * - The heraldic images (flags and arms) from Vector-Images.com database are not included to the general search. The links go to http://vector-images.com
Example of HTML code with iframe:
<iframe src="https://cliparto.com/apis/?param[query]=abstract+background¶m[type]=¶m[cols]=4¶m[imgnum]=12</iframe>
And how it looks on website:
Advanced Parameters for Developers
GET-parameter | Description and possible values |
param[type] | Type of images: photo, vector or heraldry; if blank it will show all the images except heraldry |
param[query] | Search keywords |
param[page] | Number of linked page with search results. Default: 1 |
param[sorting] | How to sort images: rate (default), name or date |
param[imgnum] | Number of images per page: 1 - 50. Default: 25 |
param[cols] | Number of images per row: 1 - 10. Default: 5 |
param[vinyl] | 0 - All the images (default). 1 - Vinyl-Ready images only |
param[thmblarge] | 0 - No larger thumbnail (default). 1 - Allow to view larger thumbnail (watermarked); unavailable for heraldry |
param[imgid] | 0 - No Image ID shown (default). 1 - Allow to view Image ID |
param[aff] | Affiliate ID (login). If blank no link from thumbnail image |
param[dlink] | 0 - No download links (default). 1 - Direct download link |
param[lng] | Language: en (default), es, de, ru |
param[thmbsize] | Thumbnail size (px): 75 - 150. Default: 100 |
param[set] | Internal area code (heraldry only; e.g. 119 for the United States; accordingly to Vector-Images.com) |
param[css] | URL to the external CSS file (e.g., http://domain/style.css) |
param[custom] | Custom selection of the images: 0 - No custom selection (default). 1 - The images stored at LightBox only (accordingly for affiliate login = param[aff]). The parameter replaces param[query] (but except param[type]=heraldry, where param[query] remains). |
XML-tag | XML-parameter | Description and possible values |
total | imgtotal | Number of images found |
imgpage | Current page |
pagestotal | Number of the pages total |
item | id | Unique Image ID |
srclink | URL to the image page on Cliparto |
imgtitle | Image title |
jpglink | Direct download link to JPG file |
epslink | Direct download link to EPS file |
thmbsrc | Link to the small thumbnail |
price | Download price (USD) |
set | Internal area code (heraldry only) |
thmblargesrc | Link to the larger thumbnail (clipart only) |
Direct Download GET Request
Example of Direct Download GET Request:
http://cliparto.com/download/ImageID/FileFormat/ImageSize/?login=Login&md5=MD5(ImageID.FileFormat.ImageSize.UserID.APIKey)
where:
ImageID - unique Id of the image at Cliparto;
FileFormat - jpg (for all images) or additional file format (eps, cdr or svg for vector images or png if available);
ImageSize - optional; from 1 to 5 (1=S to 5=XXL), jpg file only. If blank - largest image size available;
Login - user's login at Cliparto
UserID, APIKey - User ID and API Key. You can find these parameters at your account settings;
MD5 - MD5 hash for all the parameters above except Login:
string_to_hash=$ImageID.$FileFormat.$ImageSize.$UserID.$APIKey;
$md5=md5($string_to_hash);
The request returns the file requested or error page. The download cost is to charge from user's account.
The license type is standard by default. If you wish to submit request to download the image by the Extended license you can just add GET parameter &license=ext to your GET request. |