LogOn | My Account | Buy Volume Plan |

home page

Developers API

Image Search(XML)

Image Search(JSON)

Image Details(XML)

Image Details(JSON)

"Cut and Paste" examples

The best way to programmatically interact with FeaturePics is to use our APIs.

FeaturePics have published general search functions. Feel free to request e-Commerce API by email.

This is the first API beta release; more functions will be added to the next release.

Please contact FeaturePics by email to request an API Key or e-Commerce API.
All emails will be reviewed within 24 hours.

You may also send general comments, questions, or image requests using the email form at: contact page

Developers API: Image Search - JSON format

HTTP GET Request:

GET GetImagesJSON.aspx?Callback=string&Key=string&Keywords=string
&PageNumber=string&NumberPerPage=string&PagesAhead=string&Type=string

HTTP GET Request without API Key:

GET GetImagesJSON.aspx?Callback=string&Keywords=string&NumberPerPage=string&Type=string

Host: AdminServices.FeaturePics.com

Parameters:

Key - API Key.
Optional. Max 100 images will be returned if Empty.
We issue you an API Key per your request. When you have one - you will be able to navigate through pages and use our e-Commerce API. You can use this Web Service without the API Key. A maximum of 100 images will be returned per your Search request.
Keywords - HTML encoded search string.
Optional. Most recent images will be returned if Empty.
PageNumber - your navigation page number.
Optional. Default value=1 will be set if Empty.
NumberPerPage - number of images on your page.
Optional. Default value=5 will be set if Empty.
PagesAhead - number of pages ahead if you use numeric navigation.
Optional. Default value=0 will be set if Empty.
If you use numeric type of navigation like:

Please set PagesAhead=number of available pages ahead.
In the example above you need to know only if the maximum 5 pages ahead are available.
If you send us this information - the search will be performed faster.
Set PagesAhead=-1 if you use a different type of navigation and need to return a total number of images.
Type - has 2 options. "IMAGE" - search for photos and illustrations, "CLIPART" - search for illustrations only.
Optional. "IMAGE" option will be set if Empty.
Callback - Javascript callback function name

JSON Response:

{
"Error": [string],
"TotalImages": [int],
"PageId": [int],
"PagesAhead": [int],
"Images": [
{
"ImageId": [int],
"ImageFile": [string],
"ImageName": [string],
"ImagePage": [string],
"Width": [int],
"Height": [int]
},
...
]
}

Response nodes:

Error - check it first, and if empty - read the rest of the nodes
TotalImages - total available images will be returned if you set PagesAhead=0, 0 will be returned if you use a numeric type of navigation.
PageId - current page id
PagesAhead - number of available pages ahead
ImageId - ImageId in featurePics collection for further references
ImageFile - URL of image thumbnail
ImageName - Image name
ImagePage - URL of the Image page at FeaturePics.com
Width - thumbnail width
Height - thumbnail height

Example 1:
5 (by default) illustrations that match "cartoon girl" will be returned in JSON format and shown by ShowImages function.
The call you need to make:
http://adminservices.featurepics.com/GetImagesJSON.aspx?Callback=ShowImages&Keywords=cartoon%20girl&Type=CLIPART

<style>
.b{ display:inline; float:left; height:120px; }
.im{padding:5px; margin:5px;border:1px solid #cccccc;}
</style>
<div id="imgs"></div>
<script>
function ShowImages(root) {
var error = root.Error;
if (error!="")
{
alert(error);
}
else
{
var totalimages= parseInt(root.TotalImages);
var pageid=parseInt(root.PageId);
var pagesahead=parseInt(root.PagesAhead);
var imgs = root.Images || [];
var html=[''];
for (var i = 0; i < imgs.length; i++) 
{
var img = imgs[i];
var imageid=img.ImageId;
var imagefile=img.ImageFile;
var imagename=img.ImageName;
var imagepage=img.ImagePage;
var width=img.Width;
var height=img.Height;
var im='<div class=b><a href="'+imagepage+'"><img src='+imagefile+' width='+width+' height'+height+' class=im border=0></a></div>'
html.push(im);
}
}

document.getElementById("imgs").innerHTML = html.join("");
}
</script>
<script src="http://adminservices.featurepics.com/GetImagesJSON.aspx?Callback=ShowImages&Keywords=cartoon%20girl&Type=CLIPART">
</script>

The results on your page will appear like this:

Example 2:
4 images matching "Dolphins" will be returned in JSON format and shown by ShowImages function.
The call you need to make:
http://adminservices.featurepics.com/GetImagesJSON.aspx?Callback=ShowImages&Keywords=Dolphins&NumberPerPage=4

<style>
.b{ display:inline; float:left; height:120px; }
.im{padding:5px; margin:5px;border:1px solid #cccccc;}
</style>
<div id="imgs"></div>
<script>
function ShowImages(root) {
var error = root.Error;
if (error!="")
{
alert(error);
}
else
{
var totalimages= parseInt(root.TotalImages);
var pageid=parseInt(root.PageId);
var pagesahead=parseInt(root.PagesAhead);
var imgs = root.Images || [];
var html=[''];
for (var i = 0; i < imgs.length; i++) 
{
var img = imgs[i];
var imageid=img.ImageId;
var imagefile=img.ImageFile;
var imagename=img.ImageName;
var imagepage=img.ImagePage;
var width=img.Width;
var height=img.Height;
var im='<div class=b><a href="'+imagepage+'"><img src='+imagefile+' width='+width+' height'+height+' class=im border=0></a></div>'
html.push(im);
}
}

document.getElementById("imgs").innerHTML = html.join("");
}
</script>
<script src="http://adminservices.featurepics.com/GetImagesJSON.aspx?Callback=ShowImages&Keywords=Dolphins&NumberPerPage=4">
</script>

The results on your page will appear like this:

Example 3:
When you request an API key from us, you will be able to implement navigation on your site.

http://adminservices.featurepics.com/GetImagesJSON.aspx?Callback=[Your function]&Key=[YourKey]&Keywords=cartoon%20girl&PageNumber=11&PagesAhead=6&Format=XML&Type=CLIPART

JSON format example:

{
"Error": "",
"TotalImages": 5,
"PageId": 1,
"PagesAhead": 0,
"Images": [
{
"ImageId": 377071,
"ImageFile": "http://www.featurepics.com/FI/thumb/20070711/Sweet-Cartoon-Girl-377071.jpg",
"ImageName": "Sweet Cartoon Girl",
"ImagePage": "http://www.featurepics.com/online/Sweet-Cartoon-Girl-Illustrations377071.aspx",
"Width": 99,
"Height": 100 
},
{
"ImageId": 377070,
"ImageFile": "http://www.featurepics.com/FI/thumb/20070711/Sweet-Cartoon-Girl-377070.jpg",
"ImageName": "Sweet Cartoon Girl",
"ImagePage": "http://www.featurepics.com/online/Sweet-Cartoon-Girl-Illustrations377070.aspx",
"Width": 71,
"Height": 100 
},
{
"ImageId": 366133,
"ImageFile": "http://www.featurepics.com/FI/thumb/20070629/Cute-Cartoon-Girl-Singing-366133.jpg",
"ImageName": "Cute Cartoon Girl Singing",
"ImagePage": "http://www.featurepics.com/online/Cute-Cartoon-Girl-Singing-Illustrations366133.aspx",
"Width": 85,
"Height": 100 
},
{
"ImageId": 336108,
"ImageFile": "http://www.featurepics.com/FI/thumb/20070601/54b0d362-b159-418b-ab20-4a441d57426a.jpg",
"ImageName": "Cute Cartoon Girl",
"ImagePage": "http://www.featurepics.com/online/Cute-Cartoon-Girl-Illustrations336108.aspx",
"Width": 57,
"Height": 100 
},
{
"ImageId": 335348,
"ImageFile": "http://www.featurepics.com/FI/thumb/20070531/Cute-Cartoon-Girl-Lollipop-335348.jpg",
"ImageName": "Cute Cartoon Girl with Lollipop",
"ImagePage": "http://www.featurepics.com/online/Cute-Cartoon-Girl-Lollipop-Illustrations335348.aspx",
"Width": 76,
"Height": 100 
} 
]
}