+44 20 881 67284

31,904,663 Royalty Free Stock Photos

How to use the Fotolia API

Method: search/getTags

This method returns most searched tag and most used tag on fotolia website. This method may help you to create a tags cloud.

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
type string
  • Used
  • Searched
Used
  • Most used tags to index media
  • Most used tags to search for media

Returned Values

Element (path) Name Type Description
/[n]/ name string tag
/[n]/ popularity int popularity of the tag

Example Query

GET http://API_KEY@api.fotolia.com/Rest/1/search/getTags?language_id=2&type=Searched

Example Response

[
	{
		"tag":"abstract",
		"popularity":7
	},
	{
		"tag":"adult",
		"popularity":4
	},
	{
		"tag":"animal",
		"popularity":4
	},
	{
		"tag":"architecture",
		"popularity":5
	},
	{
		"tag":"art",
		"popularity":6
	},
	{
		"tag":"artistic",
		"popularity":4
	},
	{
		"tag":"asian",
		"popularity":4
	},
	{
		"tag":"attractive",
		"popularity":5
	},
	{
		"tag":"background",
		"popularity":10
	},
	{
		"tag":"beach",
		"popularity":4
	},
	{
		"tag":"beautiful",
		"popularity":6
	},
	{
		"tag":"beauty",
		"popularity":6
	},
	{
		"tag":"black",
		"popularity":7
	},
	{
		"tag":"blue",
		"popularity":9
	},
	{
		"tag":"body",
		"popularity":4
	},
	{
		"tag":"bright",
		"popularity":5
	},
	{
		"tag":"brown",
		"popularity":5
	},
	{
		"tag":"building",
		"popularity":5
	},
	{
		"tag":"business",
		"popularity":7
	},
	{
		"tag":"chinese",
		"popularity":4
	},
	{
		"tag":"colour",
		"popularity":7
	}
]

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.
2001: Invalid Language ID
The language ID passed is not valid or doesn't exist in the fotolia available language list.
5001: Invalid Tag Type
The tag type passed is not valid or doesn't exist in the available tag type list