getMediaData

This method return all information about a media

Authentication

This method does not require authentication.

Arguments

Argument Type Element (array) Valid Values Default Value Detail
api_key string Valid Values required you need a valid api key to use the API
id int existing media id required unique media id
thumbnail_size Int
  • 30
  • 110
  • 400
 required
  • Small (30px)
  • Medium (110px)
  • Large (400px - watermarked)
language_id Int
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
 2
  • French
  • English US
  • English UK
  • German
  • Spanish
  • Italian
  • Portuguese PT
  • Portuguese BR

Returned Values

Element (path) Name Type Description
/ id int media unique ID
/ title string media title (orginal name)
/ creator_name string media creator name
/ creator_id int media creator id
/ media_type_id int media type :
  • 1 : photo
  • 2 : illustration
  • 3 : vector
/ thumbnail_url string media thumbnail url
/ thumbnail_width int media thumbnail width
/ thumbnail_height int media thumbnail_height
/ thumbnail_html_tag string media thumbnail html source code
/ country_id int media country ID
/ country_name string media unique name
/ nb_views int media views number
/ nb_downloads int media downloads number
/keywords/[n]/ name string media keywords (ranked by pertinence)
/licenses/ name string media license name
/licenses/ price int media license price (credit)
/licenses_details/ name string media license name
/licenses_details/name/ width int media license width
/licenses_details/name/ height int media license height
/licenses_details/name/ dpi int media license resolution (dpi)
/licenses_details/phrase/ phrase string media license format description
/cat1/ id int media representative category ID
/cat1/ name string media representative category name
/cat2/ id int media conceptual category ID
/cat2/ name string media conceptual category name
/cat1_hierarchy/[n]/ id int media representative category ID (n depends on hierarchy level)
/cat1_hierarchy/[n]/ name string media representative category name (n depends on hierarchy level)
/cat2_hierarchy/[n]/ id int media conceptual category ID (n depends on hierarchy level)
/cat2_hierarchy/[n]/ name string media conceptual category name (n depends on hierarchy level)

Example Query


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

Example Response


<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>id</name>
            <value>
              <int>20</int>
            </value>
          </member>
          <member>
            <name>title</name>
            <value>
              <string>insecte sans issue</string>
            </value>
          </member>
          <member>
            <name>creator_name</name>
            <value>
              <string>Guy Turro</string>
            </value>
          </member>
          <member>
            <name>creator_id</name>
            <value>
              <int>18</int>
            </value>
          </member>
          <member>
            <name>media_type_id</name>
            <value>
              <int>1</int>
            </value>
          </member>
          <member>
            <name>thumbnail_url</name>
            <value>
              <string>http://static-p1.fotolia.com/jpg/00/00/00/00/400_F_20_xSvckxpOlCJSU4hLrMyJTnhBbXX3Jt.jpg</string>
            </value>
          </member>
          <member>
            <name>thumbnail_width</name>
            <value>
              <int>400</int>
            </value>
          </member>
          <member>
            <name>thumbnail_height</name>
            <value>
              <double>294</double>
            </value>
          </member>
          <member>
            <name>thumbnail_html_tag</name>
            <value>
              <string><img src="http://static-p1.fotolia.com/jpg/00/00/00/00/400_F_20_xSvckxpOlCJSU4hLrMyJTnhBbXX3Jt.jpg" alt="insecte sans issue" title="insecte sans issue" width="400" height="294" zoom_ratio="1.64882071" /></string>
            </value>
          </member>
          <member>
            <name>country_id</name>
            <value>
              <int>756</int>
            </value>
          </member>
          <member>
            <name>country_name</name>
            <value>
              <string>Switzerland</string>
            </value>
          </member>
          <member>
            <name>nb_views</name>
            <value>
              <int>845</int>
            </value>
          </member>
          <member>
            <name>nb_downloads</name>
            <value>
              <int>1</int>
            </value>
          </member>
          <member>
            <name>keywords</name>
            <value>
              <array>
                <data>
                  <value>
                    <struct>
                      <member>
                        <name>name</name>
                        <value>
                          <string>insect</string>
                        </value>
                      </member>
                    </struct>
                  </value>
                  <value>
                    <struct>
                      <member>
                        <name>name</name>
                        <value>
                          <string>macro</string>
                        </value>
                      </member>
                    </struct>
                  </value>
                  <value>
                    <struct>
                      <member>
                        <name>name</name>
                        <value>
                          <string>celebrity</string>
                        </value>
                      </member>
                    </struct>
                  </value>
                </data>
              </array>
            </value>
          </member>
          <member>
            <name>licenses</name>
            <value>
              <array>
                <data>
                  <value>
                    <struct>
                      <member>
                        <name>name</name>
                        <value>
                          <string>M</string>
                        </value>
                      </member>
                      <member>
                        <name>price</name>
                        <value>
                          <int>5</int>
                        </value>
                      </member>
                    </struct>
                  </value>
                </data>
              </array>
            </value>
          </member>
          <member>
            <name>licenses_details</name>
            <value>
              <struct>
                <member>
                  <name>M</name>
                  <value>
                    <struct>
                      <member>
                        <name>ratio</name>
                        <value>
                          <double>1.245663</double>
                        </value>
                      </member>
                      <member>
                        <name>width</name>
                        <value>
                          <double>1606</double>
                        </value>
                      </member>
                      <member>
                        <name>height</name>
                        <value>
                          <double>1183</double>
                        </value>
                      </member>
                      <member>
                        <name>dpi</name>
                        <value>
                          <int>72</int>
                        </value>
                      </member>
                      <member>
                        <name>phrase</name>
                        <value>
                          <string>1606 x 1183 (1,8 MP), 22,3 '' x 16,4 '' @72 dpi</string>
                        </value>
                      </member>
                    </struct>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>cat1</name>
            <value>
              <struct>
                <member>
                  <name>id</name>
                  <value>
                    <int>4001008</int>
                  </value>
                </member>
                <member>
                  <name>name</name>
                  <value>
                    <string>Insect</string>
                  </value>
                </member>
              </struct>
            </value>
          </member>
          <member>
            <name>cat1_hierarchy</name>
            <value>
              <array>
                <data>
                  <value>
                    <struct>
                      <member>
                        <name>id</name>
                        <value>
                          <int>4000000</int>
                        </value>
                      </member>
                      <member>
                        <name>name</name>
                        <value>
                          <string>Fauna &amp; Flora</string>
                        </value>
                      </member>
                    </struct>
                  </value>
                  <value>
                    <struct>
                      <member>
                        <name>id</name>
                        <value>
                          <int>4001000</int>
                        </value>
                      </member>
                      <member>
                        <name>name</name>
                        <value>
                          <string>Animal</string>
                        </value>
                      </member>
                    </struct>
                  </value>
                  <value>
                    <struct>
                      <member>
                        <name>id</name>
                        <value>
                          <int>4001008</int>
                        </value>
                      </member>
                      <member>
                        <name>name</name>
                        <value>
                          <string>Insect</string>
                        </value>
                      </member>
                    </struct>
                  </value>
                </data>
              </array>
            </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.
100: Missing Media ID
The media ID is missing. Media ID is required for this method.
101: Invalid Media ID
The media ID passed is not valid or doesn't correspond to any media.
2001: Invalid Language ID
The language ID passed is not valid or doesn't exist in the fotolia available language list.
2101: Invalid Thumbnail Size
The thumbnail size passed is not valid or doesn't exist in the fotolia available thumbnail size list.