Method: 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 authentification
Arguments
| Argument | Type | Valid Values | Default Value | Detail | ||
|---|---|---|---|---|---|---|
api_key |
string | Valid Values | required | you need a valid api key to use the API | ||
language_id |
Int |
|
2 |
|
||
type |
string |
|
Used |
|
Returned Values
| Element (path) | Name | Type | Description | ||
|---|---|---|---|---|---|
| /[n]/ | name |
string | tag | ||
| /[n]/ | popularity |
int | popularity of the tag |
Example Query
<?xml version="1.0" encoding="utf-8"?>
<methodCall>
<methodName>xmlrpc.getTags</methodName>
<params>
<param>
<value>
<string>YOUR_API_KEY</string>
</value>
</param>
<param>
<value>
<int>2</int>
</value>
</param>
<param>
<value>
<string>Searched</string>
</value>
</param>
</params>
</methodCall>
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>abstract</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>7</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>adult</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>4</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>animal</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>4</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>architecture</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>5</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>art</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>6</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>artistic</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>4</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>asian</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>4</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>attractive</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>5</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>background</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>10</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>beach</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>4</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>beautiful</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>6</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>beauty</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>6</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>black</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>7</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>blue</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>9</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>body</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>4</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>bright</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>5</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>brown</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>5</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>building</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>5</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>business</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>7</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>chinese</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>4</int>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>tag</name>
<value>
<string>colour</string>
</value>
</member>
<member>
<name>popularity</name>
<value>
<int>7</int>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</param>
</params>
</methodResponse>
Error Codes
001: Service currently unavailable- The requested service is temporarily unavailable.
002: Failed to parse request- The XML-RPC request document 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
