+49 (0)30 208 96 208

30.171.978 lizenzfreie Fotos,
Videos und Vektoren.

Wie arbeitet die Fotolia API?

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
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 11
2
  • French
  • English US
  • English UK
  • German
  • Spanish
  • Italian
  • Portuguese PT
  • Portuguese BR
  • Japanese
  • Polish
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


<?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