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 Details - XML format

HTTP GET Request:

GET GetImageDetails/ImageDetails.asmx?Key=string&ImageId=string

HTTP GET Request without API Key:

GET GetImageDetails/ImageDetails1.asmx?ImageId=string

Host: AdminServices.FeaturePics.com

Parameters:

Key - API Key.
Optional. Image thumbnail URL, image name, image caption, image page, and creator's nickname and page will be returned if Empty.
ImageId - ImageId in FeaturePics collection.
Required.

Response:

<?xml version="1.0" encoding="utf-8"?>
<Details>
<Error>string</Error>
<ImageId>int</ImageId>
<Title>string</Title>
<Caption>string</Caption>
<KeyWords>string</KeyWords>
<AuthorPage>string</AuthorPage>
<ImageThumb>string</ImageThumb>
<ImageThumb300>string</ImageThumb300>
<ImagePage>string</ImagePage>
<CreatorNickName>string</CreatorNickName>
<ModelRelease>string</ModelRelease>
<PropertyRelease>string</PropertyRelease>
<Resolution>int</Resolution>
<Licenses>
<License>
<LicenseId>int</LicenseId>
<LicenseTitle>string</LicenseTitle>
<LicenseURL>string</LicenseURL>
<MaxNumberOfSeats>int</MaxNumberOfSeats>
<SizeOptions>
<SizeOption>
<SizeOptionId>int</SizeOptionId>
<Width>int</Width>
<Height>int</Height>
<PriceForTheFirstSeat>double</PriceForTheFirstSeat> 
<AdditionalSeatPrice>double</AdditionalSeatPrice>
</SizeOption>
<SizeOption>
<SizeOptionId>int</SizeOptionId>
<Width>int</Width>
<Height>int</Height>
<PriceForTheFirstSeat>double</PriceForTheFirstSeat>
<AdditionalSeatPrice>double</AdditionalSeatPrice>
</SizeOption>
</SizeOptions>
</License>
<License>
<LicenseId>int</LicenseId>
<LicenseTitle>string</LicenseTitle>
<LicenseURL>string</LicenseURL>
<MaxNumberOfSeats>int</MaxNumberOfSeats>
<SizeOptions>
<SizeOption>
<SizeOptionId>int</SizeOptionId>
<Width>int</Width>
<Height>int</Height>
<PriceForTheFirstSeat>double</PriceForTheFirstSeat> 
<AdditionalSeatPrice>double</AdditionalSeatPrice>
</SizeOption>
<SizeOption>
<SizeOptionId>int</SizeOptionId>
<Width>int</Width>
<Height>int</Height>
<PriceForTheFirstSeat>double</PriceForTheFirstSeat>
<AdditionalSeatPrice>double</AdditionalSeatPrice>
</SizeOption>
</SizeOptions>
</License>
</Licenses>
</Details>

Response for Request without Key:

<?xml version="1.0" encoding="utf-8" ?>
<Details >
<Error />
<ImageId>int</ImageId>
<Title>string</Title>
<ImageThumb>string</ImageThumb>
<ImagePage>string</ImagePage>
<Caption /> 
<CreatorNickName>string</CreatorNickName> 
<AuthorPage>string</AuthorPage> 
</Details>

Response nodes:

Error - check it first; if Empty, read the rest of the nodes
ImageId - ImageId in FeaturePics collection for further references
ImageTitle - Short Image Title (200 characters maximum)
Caption - Image Description (1000 characters maximum)
KeyWords - Key words separated by comma or space
AuthorPage - Author's page
ImageThumb - Small Image thumbnail (130px maximum) without watermark
ImageThumb300 - Big Image thumbnail (300px maximum) with watermark
ImagePage - URL of the Image page at FeaturePics.com
CreatorNickName - Image Author's (Creator's) nickname
ModelRelease - Model release(s) - Yes/No
PropertyRelease - Property release(s) - Yes/No
Resolution - Resolution in dpi (dots per inch)
Licenses:
1. Royalty Free (RF) Image License is a default license.
2. Social Site License - This license can accompany our general RF license if you do a special request.
This type of license offer $1 (web size)-$5(original size) images for education and social sites.

Each License described as:
LicenseId - LicenseId in FeaturePics collection
LicenseTitle - License Title
LicenseURL - License Terms and Conditions page URL
MaxNumberOfSeats - Maximum number of seats for Image License. (Royalty Free License is 1 seat, Social Site License - 10 seats maximum)

SizeOptions:
SizeOptionId - SizeOptionId in FeaturePics collection
Width - Image Width (original size or resized)
Height - Image Height (original size or resized)
PriceForTheFirstSeat - Image License price for one seat
AdditionalSeatPrice - Image License Price for each additional seat. Zero (0) if MaxNumberOfSeats=1

Code Example: Parse Image Details using c#

...
public struct SizeOption
{
public int SizeOptionId;
public int Width;
public int Height;
public double PriceForTheFirstSeat;
public double AdditionalSeatPrice;
}
public struct License
{
public int LicenseId;
public string LicenseTitle;
public string LicenseURL;
public int MaxNumberOfSeats;
public SizeOption[] SizeOptions;
}
public struct Details
{
public string Error;
public int ImageId;
public string Title;
public string Caption;
public string KeyWords;
public string AuthorPage;
public string ImageThumb;
public string ImageThumb300;
public string ImagePage;
public string CreatorNickName;
public string ModelRelease;
public string PropertyRelease;
public int Resolution;
public License[] Licenses;
}
...
public void GetImage(int imageid)
{
string error = "";
Details img = new Details();
List<License> licenses = new List<License>();
License license = new License();
List<SizeOption> sizeoptions = new List<SizeOption>();
SizeOption option = new SizeOption();
HttpWebRequest Req = (HttpWebRequest)WebRequest.Create("http://adminservices.featurepics.com/imagedetails.asmx/GetImageDetails?imageid="+imageid);
WebResponse Res = Req.GetResponse();
XmlTextReader reader = new XmlTextReader(Res.GetResponseStream());
string name = "";
img.ImageId = imageid;
while (reader.Read())
{
switch (reader.NodeType)
{
case XmlNodeType.Element:
name = reader.Name.ToLower();
break;
case XmlNodeType.Text:
switch (name)
{
case "error":
error = reader.Value;
img.Error = error;
break;
case "title":
img.Title = reader.Value;
break;
case "imagethumb":
img.ImageThumb = reader.Value;
break;
case "imagepage":
img.ImagePage = reader.Value;
break;
case "caption":
img.Caption = reader.Value;
break;
case "keywords":
img.KeyWords = reader.Value;
break;
case "authorpage":
img.AuthorPage = reader.Value;
break;
case "imagethumb300":
img.ImageThumb300 = reader.Value;
break;
case "creatornickname":
img.CreatorNickName = reader.Value;
break;
case "modelrelease":
img.ModelRelease = reader.Value;
break;
case "propertyrelease":
img.PropertyRelease = reader.Value;
break;
case "resolution":
img.Resolution = Convert.ToInt32(reader.Value);
break;
case "licenseid":
license.LicenseId = Convert.ToInt32(reader.Value);
break;
case "licensetitle":
license.LicenseTitle = reader.Value;
break;
case "licenseurl":
license.LicenseURL = reader.Value;
break;
case "maxnumberofseats":
license.MaxNumberOfSeats = Convert.ToInt32(reader.Value);
break;
case "sizeoptionid":
option.SizeOptionId = Convert.ToInt32(reader.Value);
break;
case "width":
option.Width = Convert.ToInt32(reader.Value);
break;
case "height":
option.Height = Convert.ToInt32(reader.Value);
break;
case "priceforthefirstseat":
option.PriceForTheFirstSeat = Convert.ToDouble(reader.Value);
break;
case "additionalseatprice":
option.AdditionalSeatPrice = Convert.ToDouble(reader.Value);
break;
}
break;
case XmlNodeType.EndElement:
name = reader.Name.ToLower();
switch (name)
{
case "sizeoption":
sizeoptions.Add(option);
break;
case "sizeoptions":
license.SizeOptions = sizeoptions.ToArray();
break;
case "license":
sizeoptions.Clear();
licenses.Add(license);
break;
case "licenses":
img.Licenses = licenses.ToArray();
break;
}
break;
}
if (error != "")
break;
}

}

Code Example: Show Image

===Your page===
<style>
p{color:#333333;font: 12px/18px Arial, Helvetica, sans-serif;}
.t{float:left;padding-right:20px;}
a.l:{color:#778888;font: 12px/18px Arial, Helvetica, sans-serif;}
a.l:link {color:#778888;font: 12px/18px Arial, Helvetica, sans-serif;}
a.l:visited {color:#778888;font: 12px/18px Arial, Helvetica, sans-serif;}
</style>
....
<p>
<b><asp:Literal ID="Literal1" runat="server" /></b>
</p>
<p>
<asp:Literal ID="Literal2" runat="server" />
</p>
<div>
<asp:HyperLink ID="HyperLink1" runat="server" CssClass="t" />
<p>
Image page:
<asp:HyperLink ID="HyperLink2" runat="server" CssClass="l" />
</p>
<p>
Author:
<asp:HyperLink ID="HyperLink3" runat="server" CssClass="l" />
</p>
<p>
Licese:
<asp:HyperLink ID="HyperLink4" runat="server" CssClass="l" />
</p>
</div>
===c# code===
...
private void ShowImage(Details img)
{
lTitle.Text = img.Title;
lCaption.Text = img.Caption;
hImg.ImageUrl = img.ImageThumb;
hImg.NavigateUrl = img.ImagePage;
hImgPage.NavigateUrl = img.ImagePage;
hImgPage.Text = img.ImagePage;
hAuthor.NavigateUrl = img.AuthorPage;
hAuthor.Text = img.CreatorNickName;
hLicense.NavigateUrl = img.Licenses[0].LicenseTitle;
hLicense.Text = img.Licenses[0].LicenseURL;
}
...

The results will be shown like below:

Stunt Bike Rider -- A dirt bike rider doing aerial stunts at an event show, with the rider hand standing on the bike in the air (Editorial Use Only).

Image http://www.featurepics.com/online/Stunt-Bike-Rider-Pics201880.aspx by Gracey

Response Example:

<Details> 
<Error /> 
<ImageId>201880</ImageId> 
<Title>Stunt Bike Rider</Title> 
<Caption>A dirt bike rider doing aerial stunts at an event show, with the rider handstanding on the bike in the air (Editorial Use Only).</Caption> 
<KeyWords>aerial,bike,bmx,boy,dirtbike,entertainment,event,freestyle,gloves, handstand,helmet,male,man,rider,safety,show,sky,sports,stunt,teen,upsidedown</KeyWords> 
<AuthorPage>http://www.featurepics.com/Authors/Images177.aspx</AuthorPage> 
<ImageThumb>FI/Thumb/20070127/Stunt-Bike-Rider-201880.jpg</ImageThumb> 
<ImageThumb300>FI/Thumb300V/20070127/Stunt-Bike-Rider-201880.jpg</ImageThumb300>
<ImagePage>http://www.featurepics.com/online/Stunt-Bike-Rider-Pics201880.aspx</ImagePage>
<CreatorNickName>Gracey</CreatorNickName>
<ModelRelease>NO</ModelRelease>
<PropertyRelease>NO</PropertyRelease>
<Resolution>300</Resolution>
<Licenses>
<License>
<LicenseId>11</LicenseId>
<LicenseTitle>Social Site Image License</LicenseTitle>
<LicenseURL>http://www.featurepics.com/HelpCenter/SocialSiteLicense.html</LicenseURL>
<MaxNumberOfSeats>10</MaxNumberOfSeats>
<SizeOptions>
<SizeOption>
<SizeOptionId>1</SizeOptionId>
<Width>848</Width>
<Height>600</Height>
<PriceForTheFirstSeat>1</PriceForTheFirstSeat>
<AdditionalSeatPrice>0.5</AdditionalSeatPrice>
</SizeOption>
<SizeOption>
<SizeOptionId>2</SizeOptionId>
<Width>3200</Width>
<Height>2262</Height>
<PriceForTheFirstSeat>5</PriceForTheFirstSeat>
<AdditionalSeatPrice>1</AdditionalSeatPrice>
</SizeOption>
</SizeOptions>
</License>
<License>
<LicenseId>3</LicenseId>
<LicenseTitle>Royalty Free Editorial(RFE)</LicenseTitle>
<LicenseURL>http://www.featurepics.com/HelpCenter/LicenseRoyaltyFreeEditorial.html</LicenseURL>
<MaxNumberOfSeats>1</MaxNumberOfSeats>
<SizeOptions>
<SizeOption>
<SizeOptionId>1</SizeOptionId>
<Width>849</Width>
<Height>600</Height>
<PriceForTheFirstSeat>2.83</PriceForTheFirstSeat>
<AdditionalSeatPrice>0</AdditionalSeatPrice>
</SizeOption>
<SizeOption>
<SizeOptionId>2</SizeOptionId> 
<Width>3200</Width>
<Height>2262</Height>
<PriceForTheFirstSeat>8</PriceForTheFirstSeat>
<AdditionalSeatPrice>0</AdditionalSeatPrice>
</SizeOption>
</SizeOptions>
</License>
</Licenses>
</Details>