How to use the Fotolia API

Method: search/getTags

• Authentication
• HTTP method
• Arguments
• Returned Values
• Example Query
• Example Response
• Error Codes

Authentication

This method does not require authentication.

HTTP method

This method is called with HTTP method GET.

Arguments

Returned Values

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