SEARCH

// developer.daylife.com


Image Calls

image_getTopics

This method is used to retrieve topics from within the given image.

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/image_getTopics?image_id=0f27aLTfO1fNa
    &offset=&limit=10&source_filter_id=<source_filter_id>&include_topic_type=
    &accesskey=<accesskey>&signature=<signature>

Input Parameters

Name Description Type Required Sample Values Default Value
accesskey string Y <your_access_key> N/A
signature* string Y <calculated_signature> N/A
image_id The image_id or a list of name-value pairs of image_id's string Y 03cV5zI2fk03s N/A
source_filter_id The source_filter_id given you by Daylife which contains your authorized image sources string N (though you won't get results without one) 07FM3UO6tCdAE N/A
limit The number of related topics to be returned integer N 40 10
offset Integer count of topics to be offset from the first returned topic. Useful for paging through large numbers of associated topics (which you won't have to do very often with images) integer N 5 0
include_topic_type one or more name value pairs indicating which sorts of topics you wish to include string N PERSON, ORGANIZATION, PLACE, EVENT, HOLIDAY, ISSUE, SPORT, STATION, PRODUCT, DRUG, DISEASE All types of topics
include_image Flag that indicates if a thumbnail image for each topic should be returned if available. integer N 0 or 1 0

 

Sample Output:

<response>
  <message type='str'>Success</message>
  <code type='int4'>2001</code>
  <payload>
    <topic>
      <daylife_url type='str'>http://www.daylife.com/topic/Michelle_Obama</daylife_url>
      <topic_id type='str'>0dwKd1i6ledJN</topic_id>
      <hero_image>
        <image_id type='str'>00Fh9CI0nS5tN</image_id>
        <hero_image_id type='str'>09Bl6yz6vNgQC</hero_image_id>
        <hero_image_url type='str'>http://cache.daylife.com/imageserve/09Bl6yz6vNgQC/60x60.jpg</hero_image_url>
      </hero_image>
      <type type='str'>PERSON</type>
      <name type='str'>Michelle Obama</name>
    </topic>
    <topic>
      <daylife_url type='str'>http://www.daylife.com/topic/Wal-Mart</daylife_url>
      <topic_id type='str'>0dsv7hMgbE4FE</topic_id>
      <hero_image>
        <hero_image_id type='str'>0bBlaje7hO3JI</hero_image_id>
        <hero_image_url type='str'>http://cache.daylife.com/imageserve/0bBlaje7hO3JI/60x60.jpg</hero_image_url>
      </hero_image>
      <type type='str'>ORGANIZATION</type>
      <name type='str'>Wal-Mart</name>
    </topic>
  </payload>
</response>

image_getInfo

This method is used to retrieve information about one or more article IDs.

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/image_getInfo?image_id=0f27aLTfO1fNa
    &source_filter_id=<source_filter_id>&accesskey=<accesskey>&signature=<signature>

Input Parameters

Name Description Type Required Sample Values Default Value
accesskey string Y <your_access_key> N/A
signature* string Y <calculated_signature> N/A
image_id The image id or a list of name-value pairs of image_id's string Y 0f27aLTfO1fNa N/A
source_filter_id The id provided you by Daylife, which grants you access via the API to image providers with which you have a license string N, but you're not likely to get a good response without a source_fitler_id   N/A

 

Sample Output:

<response>
  <message type='str'>Success</message>
  <code type='int4'>2002</code>
  <payload>
    <image>
      <category type='str'>POL</category>
      <thumb_url type='str'>http://cache.daylife.com/imageserve/0f27aLTfO1fNa/45x45.jpg</thumb_url>
      <timestamp_epoch type='int4'>1295542800</timestamp_epoch>
      <license type='str'>getty_premiumaccess_401</license>
      <license type='str'>getty_premiumaccess_705</license>
      <license type='str'>getty_premiumaccess_708</license>
      <license type='str'>getty_premiumaccess_932</license>
      <license type='str'>getty_editorialsubscription_19</license>
      <license type='str'>getty_editorialsubscription_20</license>
      <license type='str'>getty_editorialsubscription_18</license>
      <author type='str'>MANDEL NGAN</author>
      <url type='str'>http://cache.daylife.com/imageserve/0f27aLTfO1fNa/159x200.jpg</url>
      <daylife_url type='str'>http://www.daylife.com/image/0f27aLTfO1fNa</daylife_url>
      <image_id type='str'>0f27aLTfO1fNa</image_id>
      <getty_collection_name type='str'>AFP</getty_collection_name>
      <credit type='str'>AFP/Getty Images</credit>
      <height type='int4'>200</height>
      <width type='int4'>159</width>
      <page_url type='str'>108191588.jpg</page_url>
      <cluster_id type='int4'>108180634</cluster_id>
      <source>
        <name type='str'>Getty Images</name>
        <url type='str'>http://gettyimages.com/</url>
        <daylife_url type='str'>http://www.daylife.com/source/Getty_Images</daylife_url>
        <rank type='int4'>1</rank>
        <favicon_url type='str'>http://favicon.daylife.com/imageserve/0a9L9fsaU55wK/favicon.png</favicon_url>
        <source_id type='str'>0a9L9fsaU55wK</source_id>
        <type type='str'>IMAGE</type>
      </source>
      <getty_composition type='str'>Vertical</getty_composition>
      <timestamp type='str'>2011-01-20 17:00:00</timestamp>
      <location_keywords type='str'>USA</location_keywords>
      <location_keywords type='str'>Washington DC</location_keywords>
      <location_keywords type='str'>Washington</location_keywords>
      <location_keywords type='str'>District of Columbia</location_keywords>
      <image_title type='str'>US First Lady Michelle Obama speaks as s</image_title>
      <caption type='str'>US First Lady Michelle Obama speaks as she joins business leaders from Walmart, an American public multinational corporation that runs a chain of large discount department stores and a chain of warehouse stores, for an announcement impacting food formulation, availability and affordability in Washington, DC, on January 20, 2011.</caption>
      <getty_concept type='str'>Accessibility</getty_concept>
      <getty_concept type='str'>Leadership</getty_concept>
    </image>
  </payload>
</response>