FeaturePics Search Images in JSON format

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

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:
[hostname]/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="[hostname]/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:
[hostname]/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="[hostname]/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.

[hostname]/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 
} 
]
}

Sign Up FREE	Contact How Do I Terms Of Use Privacy Policy	Royalty-Free Business Extension, Commercial Goods Business Extension, Publications Business Extension, Logo-Type Purposes "Comp Usage" License Open Image Suite User License	Developers API RSS: Recent Images RSS: Image by Category
	2005-2013, FeaturePics and FeatureImage, Fremont, California. All rights reserved.