withVectorsTab-97x42
We's got 20,157,190 images, yo!

API Access

API Documentation - getMediaData

This method allows you to get data about a media file.

Authentication

This method does not require authentication.

Arguments

Argument Type Element (array) Valid Values Default Value Detail
api_key string none you need a valid api key to use the API
id int existing media id none unique media id
thumbnail_size int
  • 110
  • 400
none Determines the size of thumbnail that the thumbnail information returned points to

Returned Values

Element (path) Name Type Description
/ id int media id for the file
/ title string title for the file
/ creator_name string photographer name
/ creator_id int photographer id
/ creation_date string date file was added
/ media_type_id int type of media file:
  • 1 - Photo
  • 2 - Illustration
  • 3 - Vector
/ thumbnail_url string url to the thumbnail
/ thumbnail_width int width of the thumbnail
/ thumbnail_height int height of the thumbnail
/ thumbnail_html_tag string html tag to use to display the thumbnail
/ nb_views int number of times the media has been viewed
/ nb_downloads int number of times the media has been downloaded
/ width int width of the full size file
/ height int height of the full size file
/ vector_type string only present on vector media, will be one of:
  • svg
  • zip
/ keywords array array of keywords for the media
/ cat1 string first category name for the file
/ cat2 string second category name for the file

Example Query


<?xml version="1.0" encoding="utf-8"?>
<methodCall>
  <methodName>media.getMediaData</methodName>
  <params>
    <param>
      <value>
        <string>YOUR_API_KEY</string>
      </value>
    </param>
    <param>
      <value>
        <int>14624813</int>
      </value>
    </param>
    <param>
      <value>
        <int>110</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>14624813</int>
            </value>
          </member>
          <member>
            <name>title</name>
            <value>
              <string>Pretty young woman with a fur hood. Close-up eyes.</string>
            </value>
          </member>
          <member>
            <name>creator_name</name>
            <value>
              <string>Artsiom Kireyau</string>
            </value>
          </member>
          <member>
            <name>creator_id</name>
            <value>
              <int>847487</int>
            </value>
          </member>
          <member>
            <name>creation_date</name>
            <value>
              <string>2010-03-04 08:26:04.437228</string>
            </value>
          </member>
          <member>
            <name>media_type_id</name>
            <value>
              <int>1</int>
            </value>
          </member>
          <member>
            <name>thumbnail_url</name>
            <value>
              <string>
              http://static-p2.photoxpress.com/jpg/00/14/62/48/110_F_14624813_YHS2cudTjmdrg3iXRJqufGkAoGPuW0tv_PXP.jpg</string>
            </value>
          </member>
          <member>
            <name>thumbnail_width</name>
            <value>
              <int>110</int>
            </value>
          </member>
          <member>
            <name>thumbnail_height</name>
            <value>
              <int>73</int>
            </value>
          </member>
          <member>
            <name>thumbnail_html_tag</name>
            <value>
              <string><img
              src="http://static-p2.photoxpress.com/jpg/00/14/62/48/110_F_14624813_YHS2cudTjmdrg3iXRJqufGkAoGPuW0tv_PXP.jpg"
              alt="green woman female stock photo" title="green woman
              female"/></string>
            </value>
          </member>
          <member>
            <name>nb_views</name>
            <value>
              <int>360</int>
            </value>
          </member>
          <member>
            <name>nb_downloads</name>
            <value>
              <int>3</int>
            </value>
          </member>
          <member>
            <name>width</name>
            <value>
              <int>2550</int>
            </value>
          </member>
          <member>
            <name>height</name>
            <value>
              <int>1700</int>
            </value>
          </member>
          <member>
            <name>keywords</name>
            <value>
              <array>
                <data>
                  <value>
                    <string>green</string>
                  </value>
                  <value>
                    <string>woman</string>
                  </value>
                  <value>
                    <string>female</string>
                  </value>
                  <value>
                    <string>model</string>
                  </value>
                  <value>
                    <string>face</string>
                  </value>
                  <value>
                    <string>girl</string>
                  </value>
                  <value>
                    <string>eyes</string>
                  </value>
                  <value>
                    <string>fashion</string>
                  </value>
                  <value>
                    <string>pretty</string>
                  </value>
                  <value>
                    <string>beautiful</string>
                  </value>
                  <value>
                    <string>look</string>
                  </value>
                  <value>
                    <string>person</string>
                  </value>
                  <value>
                    <string>young</string>
                  </value>
                  <value>
                    <string>youth</string>
                  </value>
                  <value>
                    <string>winter</string>
                  </value>
                  <value>
                    <string>cold</string>
                  </value>
                  <value>
                    <string>coat</string>
                  </value>
                  <value>
                    <string>fur</string>
                  </value>
                  <value>
                    <string>cute</string>
                  </value>
                  <value>
                    <string>clothing</string>
                  </value>
                  <value>
                    <string>clothes</string>
                  </value>
                  <value>
                    <string>fresh</string>
                  </value>
                  <value>
                    <string>portrait</string>
                  </value>
                  <value>
                    <string>hair</string>
                  </value>
                  <value>
                    <string>happy</string>
                  </value>
                  <value>
                    <string>modern</string>
                  </value>
                  <value>
                    <string>beauty</string>
                  </value>
                  <value>
                    <string>hood</string>
                  </value>
                  <value>
                    <string>luxury</string>
                  </value>
                  <value>
                    <string>closeup</string>
                  </value>
                  <value>
                    <string>perfect</string>
                  </value>
                  <value>
                    <string>miss</string>
                  </value>
                  <value>
                    <string>people</string>
                  </value>
                  <value>
                    <string>lady</string>
                  </value>
                  <value>
                    <string>sexy</string>
                  </value>
                  <value>
                    <string>lips</string>
                  </value>
                  <value>
                    <string>attractive</string>
                  </value>
                  <value>
                    <string>adult</string>
                  </value>
                  <value>
                    <string>close</string>
                  </value>
                  <value>
                    <string>elegance</string>
                  </value>
                  <value>
                    <string>gorgeous</string>
                  </value>
                  <value>
                    <string>dress</string>
                  </value>
                  <value>
                    <string>one</string>
                  </value>
                  <value>
                    <string>lovely</string>
                  </value>
                  <value>
                    <string>makeup</string>
                  </value>
                  <value>
                    <string>make</string>
                  </value>
                  <value>
                    <string>brunette</string>
                  </value>
                  <value>
                    <string>glamour</string>
                  </value>
                  <value>
                    <string>seductive</string>
                  </value>
                  <value>
                    <string>hairstyle</string>
                  </value>
                </data>
              </array>
            </value>
          </member>
          <member>
            <name>cat1</name>
            <value>
              <string>Welfare</string>
            </value>
          </member>
          <member>
            <name>cat2</name>
            <value>
              <string>People</string>
            </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>