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


<?xml version="1.0" encoding="utf-8"?>
<methodCall>
	<methodName>xmlrpc.getCategories1</methodName>
	<params>
		<param>
			<value>
				<string>YOUR_API_KEY</string>
			</value>
		</param>
		<param>
			<value>
				<int>1000000</int>
			</value>
		</param>
	</params>
</methodCall>

Example Response


<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>42</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1008000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Sky</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>47</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1009000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Submarine landscape</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>48</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1010000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Wild landscape</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>49</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1011000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Natural disaster</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>57</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1012000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Bird's Eye View</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>58</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1100000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Autres</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>19</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1004000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Mountain</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>26</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>1005000</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Island</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
        </struct>
      </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.
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