+44 20 881 67284

33,765,111 Royalty Free Stock Photos

How to use the Fotolia API

Method: search/getCategories1

This method returns childs of a parent category in fotolia representative category system. This method could be used to display a part of the category system or the all tree. Fotolia categories system counts three levels.

Authentication

This method does not require authentication.

HTTP method

This method is called with HTTP method GET.

Arguments

Argument Type Valid Values Default Value Detail
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
id int existing category ID or blank none parent category ID - if this field is not populated first level categories are returned

Returned Values

Element (path) Name Type Description
/[n]/ name string category name
/[n]/ id int category ID

Example Query

GET http://API_KEY@api.fotolia.com/Rest/1/search/getCategories1?language_id=2&id=1000000

Example Response

{
	"42":{
		"id":1008000,
		"name":"Sky"
	},
	"47":{
		"id":1009000,
		"name":"Submarine landscape"
	},
	"48":{
		"id":1010000,
		"name":"Wild landscape"
	},
	"49":{
		"id":1011000,
		"name":"Natural disaster"
	},
	"57":{
		"id":1012000,
		"name":"Bird's Eye View"
	},
	"58":{
		"id":1100000,
		"name":"Autres"
	},
	"19":{
		"id":1004000,
		"name":"Mountain"
	},
	"26":{
		"id":1005000,
		"name":"Island"
	}
}

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.
301: Invalid Category ID
The category ID passed is not valid or doesn't exist in the fotolia category system
2001: Invalid Language ID
The language ID passed is not valid or doesn't exist in the fotolia available language list