+1 (888) 674-2299

32,517,129 Royalty Free Stock Photos

How to use the Fotolia API

Method: media/getMediaData

This method return all information about a media

Authentication

This method does not require authentication.

HTTP method

This method is called with HTTP method GET.

Arguments

Argument Type Element (array) Valid Values Default Value Detail
id int existing media id required unique media id
thumbnail_size Int
  • 110
  • 400
required
  • Medium (110px)
  • Large (400px - watermarked)
language_id Int
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 11
  • 12
  • 13
  • 14
  • 15
  • 22
  • 23
2
  • French
  • American
  • English
  • German
  • Spanish
  • Italian
  • Portuguese
  • Brazilian
  • Japanese
  • Polish
  • Russian
  • Chinese
  • Turkish
  • Korean
  • Dutch
  • Swedish
secure_urls Int 0 Returns HTTPS urls

Returned Values

Element (path) Name Type Description
/ id int media unique ID
/ title string media title (orginal name)
/ creator_name string media creator name
/ creator_id int media creator id
/ media_type_id int media type :
  • 1 : photo
  • 2 : illustration
  • 3 : vector
/ thumbnail_url string media thumbnail url
/ thumbnail_width int media thumbnail width
/ thumbnail_height int media thumbnail_height
/ thumbnail_html_tag string media thumbnail html source code
/ country_id int media country ID
/ country_name string media unique name
/ nb_views int media views number
/ nb_downloads int media downloads number
/keywords/[n]/ name string media keywords (ranked by pertinence)
/licenses/ name string media license name
/licenses/ price int media license price (credit)
/licenses_details/ name string media license name
/licenses_details/name/ width int media license width
/licenses_details/name/ height int media license height
/licenses_details/name/ dpi int media license resolution (dpi)
/licenses_details/phrase/ phrase string media license format description
/cat1/ id int media representative category ID
/cat1/ name string media representative category name
/cat2/ id int media conceptual category ID
/cat2/ name string media conceptual category name
/cat1_hierarchy/[n]/ id int media representative category ID (n depends on hierarchy level)
/cat1_hierarchy/[n]/ name string media representative category name (n depends on hierarchy level)
/cat2_hierarchy/[n]/ id int media conceptual category ID (n depends on hierarchy level)
/cat2_hierarchy/[n]/ name string media conceptual category name (n depends on hierarchy level)

Example Query

GET http://API_KEY@api.fotolia.com/Rest/1/media/getMediaData?id=20

Example Response

{
	"id":20,
	"title":"insecte sans issue",
	"creator_name":"Guy Turro",
	"creator_id":18,
	"media_type_id":1,
	"thumbnail_url":"http:\/\/static-p1.fotolia.com\/jpg\/00\/00\/00\/00\/400_F_20_xSvckxpOlCJSU4hLrMyJTnhBbXX3Jt.jpg",
	"thumbnail_width":400,
	"thumbnail_height":294,
	"thumbnail_html_tag":"",
	"country_id":756,
	"country_name":"Switzerland",
	"nb_views":845,
	"nb_downloads":1,
	"keywords":[
		{
			"name":"insect"
		},
		{
			"name":"macro"
		},
		{
			"name":"celebrity"
		}
	],
	"licenses":[
		{
			"name":"M",
			"price":5
		}
	],
	"licenses_details":{
		"M":{
			"ratio":1.245663,
			"width":1606,
			"height":1183,
			"dpi":72,
			"phrase":"1606 x 1183 (1,8 MP), 22,3 '' x 16,4 '' @72 dpi"
		}
	},
	"cat1":{
		"id":4001008,
		"name":"Insect"
	},
	"cat1_hierarchy":[
		{
			"id":4000000,
			"name":"Fauna & Flora"
		},
		{
			"id":4001000,
			"name":"Animal"
		},
		{
			"id":4001008,
			"name":"Insect"
		}
	]
}

Error Codes

001: Service currently unavailable
The requested service is temporarily unavailable.
002: Failed to parse request
The request could not be parsed.
010: Missing API Key
The API key passed is missing.
011: Invalid API Key
The API key passed is not valid or has expired.
031: Invalid Method
This method does not exist in the method list.
032: Method not Available
This method is not available for this API Key.
100: Missing Media ID
The media ID is missing. Media ID is required for this method.
101: Invalid Media ID
The media ID passed is not valid or doesn't correspond to any media.
2001: Invalid Language ID
The language ID passed is not valid or doesn't exist in the fotolia available language list.
2101: Invalid Thumbnail Size
The thumbnail size passed is not valid or doesn't exist in the fotolia available thumbnail size list.