SEARCH

// developer.daylife.com


Search Calls


The Search API methods return search results containing related articles, quotes, images and topics for a given query term.

Note: Search calls are useful for topics not explicitly tracked by Daylife; search calls rely a boolean search query supplied in the call context to return results.

In most cases, and where these are available, Topic Calls will provide better results. Topic calls generally return highly relevant results. Daylife has rich scoring data associated with each topic Daylife tracks that provides a degree of accuracy much harder to achieve with Search calls, especially when there are multiple possibilities for a given search term (for example, different people with the same name). In a sense, Topic calls are "pre-curated" in that Daylife tracks topics individually and has done a "first pass" against our topic database for spurious data.

search_getRelatedArticles

Returns articles that contain the given query term. (See section/appendix on search query syntax.)

Sample Invocation

http://freeapi.daylife.com/xmlrest/publicapi/4.10/
search_getRelatedArticles?accesskey=<accesskey>&signature=<signature>&query=Condoleezza+Iraq

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators.
    		 N/A
    end_time   Timestamp N 2007-03 <current time>
    start_time   Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    limit The number of results to be returned integer N 40 10
    offset   integer N 5 0
    sort   string N daterank, date, relevance.
    ** daterank is an option to sort by combination of date and relevance
    		 daterank
    source_filter_id   string N 06T8a8lavf8sc None
    source_whitelist one or more name value pairs of Daylife source ids
    		 string N source_whitelist=0a0F0VifAodow&source_whitelist=04Ew78S3C96yc None
    block_nsfw flag to indicate if content scored as obscene should be blocked integer N 1 0
    source_blacklist one or more name value pairs of Daylife source ids to exclude from returned results string N source_blacklist=0a0F0VifAodow&source_blacklist=04Ew78S3C96yc None
    has_image Flag to request that ONLY articles with associated images be returned. integer N 0 or 1 0
    include_scores Flag to indicate if enhanced score data be included for every article if available. integer N 0 or 1 0
    sliding_excerpt Flag to suppress sliding excerpts.
    		 integer N 0 or 1 1
    include_image Flag to request the return of a related article image , if available, with the article data. integer N 0 or 1 0

 Sample Output:

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<article>
			<timestamp_epoch type="int4">1200682287</timestamp_epoch>
			<source>
				<name type="str">Associated Press</name>
				<url type="str">http://hosted.ap.org/</url>
				<daylife_url type="str">http://www.daylife.com/source/Associated_Press</daylife_url>
				<rank type="int4">1</rank>
				<source_id type="str">0f279rG8jo3Is</source_id>
				<type type="int4">1</type>
				<favicon_url type="str">http://favicon.daylife.com/imageserve/0g0BarQeCPe2i/favicon.png</favicon_url>
			</source>
			<headline type="str">Sunni Sheik Offers Guns and Gets Rewards</headline>
			<timestamp type="str">2008-01-18 18:51:27</timestamp>
			<related_article_count type="int4">13</related_article_count>
			<excerpt type="str">They know him as the sheik. But what that really means in this Sunni town 
				is a bit of everything: community leader, public works supervisor, agricultural planner, 
				militia captain.
			</excerpt>
			<url type="str">http://hosted.ap.org/dynamic/stories/I/IRAQ_SHEIKS_BARGAIN?SITE=TNKNN</url>
			<daylife_url type="str">http://www.daylife.com/article/03j9fqr8kkb6B</daylife_url>
			<article_id type="str">03j9fqr8kkb6B</article_id>
			<scores>
				<newsdomain type="str">World</newsdomain>
				<op-ed type="int4">5</op-ed>
				<spinometer type="int4">-5</spinometer>
			</scores>
		</article>
		........
		........
	</payload>
</response>

 search_getMatchingTopics

This method is used to retrieve references to Daylife topics whose names match with the given query term. For example, to find the Condoleezza Rice topic, you could use query=Condoleezza.

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getMatchingTopics?
    accesskey=<accesskey>&signature=<signature>&query=United&include_image=1

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    limit the number of results to be returned integer N 40 10
    offset 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 topic types
    include_image Flag that indicates if a thumbnail image for each topic should be returned if available. integer N 0 or 1  
    include_wikipedia_info Flag to specify if wiki abstract for the topic is to be returned int N 0 or 1 0
 Sample Output:
<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<topic>
			<topic_id type="str">0dVm3LAbhJbES</topic_id>
			<type type="str">PLACE</type>
			<name type="str">United States</name>
			<daylife_url type="str">http://www.daylife.com/topic/United_States</daylife_url>
			<image>
				<url type="str">http://cache.daylife.com/imageserve/0gwb63H2Wmapg/45x45.jpg</url>
				<daylife_url type="str">http://cache.daylife.com/imageserve/0gwb63H2Wmapg/340x.jpg</daylife_url>
				<thumb_url type="str">http://cache.daylife.com/imageserve/0gwb63H2Wmapg/45x45.jpg</thumb_url>
				<timestamp_epoch type="int4">1177281949</timestamp_epoch>
				<timestamp type="str">2007-04-22 22:45:49</timestamp>
				<credit type="str">AFP/Getty Images</credit>
				<image_topic_relevance type="int4">10</image_topic_relevance>
				<width type="int4">2860</width>
				<height type="int4">2268</height>
				<image_id type="str">0gwb63H2Wmapg</image_id>
				<caption type="str">
					Vania King of the US (L) speaks with US team captain Zena Garrison (R) 
					during a break in her match against Kirsten Flipken of Belgium in the 
					quarter-finals round in the Fed Cup World Group 2007 between Belgium and 
					the US in Delray Beach, Florida 22 April 2007. King won the match 4-6, 
					6-4, 7-5 to give the US a total score of 3-0 and move to the next round
				</caption>
				<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>
					<source_id type="str">0a9L9fsaU55wK</source_id>
					<type type="int4">6</type>
				</source>
			</image>
		</topic>
		........
		........
	</payload>
</response>

 search_getMatchingSources

This method is used to retrieve references to Daylife sources whose names match with the given query term.

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getMatchingTopics?
    accesskey=<accesskey>&signature=<signature>&query=New%20York

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
    query the search term string Y "New York". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    limit the number of results to be returned integer N 40 10
    offset integer N 5 0

 Sample Output:

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<source>
			<source_id type="str">0dVm3LAbhJbES</source_id>
			<rank type="str">3</rank>
			<name type="str">New York Post</name>
                        <search_score type="float">10.0</search_score>
                        <type type="int4">1</type>
			<daylife_url type="str">http://www.daylife.com/source/New_York_Post</daylife_url>
		</source>
                <source>
		........
		........
		</source>

	</payload>
</response>
 

search_getRelatedTopics

This method is used to retrieve references to Daylife topics that have appeared in articles containing the given query term. To find specifically named topics, use the search_getMatchingTopics method call.

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getRelatedTopics?
    accesskey=<accesskey>&signature=<signature>&query=United&include_image=1

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    end_time Timestamp N 2007-03 <current time>
    start_time Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    limit the number of results to be returned integer N 40 10
    offset integer N 5 0
    sort flag to indicate the sorting order string N daterank, date, relevance.
    ** daterank is an option to sort by combination of date and relevance    		 daterank
    source_filter_id daylife source filter id string N 06T8a8lavf8sc None
    source_whitelist one or more name value pairs of Daylife source ids string N source_whitelist=0a0F0VifAodow&source_whitelist=04Ew78S3C96yc None
    source_blacklist one or more name value pairs of Daylife source ids to exclude from returned results string N source_blacklist=0a0F0VifAodow&source_blacklist=04Ew78S3C96yc None
    include_image Flag to request the return of a related article image , if available, with the article data. integer N 0 or 1 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 topic types
    include_image Flag that indicates if a thumbnail image for each topic should be returned if available. integer N 0 or 1 0
    include_wikipedia_info Flag to specify if wiki abstract for the topic is to be returned int N 0 or 1 0

 Sample Output

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<topic>
			<topic_id type="str">0dVm3LAbhJbES</topic_id>
			<type type="str">PLACE</type>
			<name type="str">United States</name>
			<daylife_url type="str">http://www.daylife.com/topic/United_States</daylife_url>
			<image>
				<url type="str">http://cache.daylife.com/imageserve/0gwb63H2Wmapg/45x45.jpg</url>
				<daylife_url type="str">http://cache.daylife.com/imageserve/0gwb63H2Wmapg/340x.jpg</daylife_url>
				<thumb_url type="str">http://cache.daylife.com/imageserve/0gwb63H2Wmapg/45x45.jpg</thumb_url>
				<timestamp_epoch type="int4">1177281949</timestamp_epoch>
				<timestamp type="str">2007-04-22 22:45:49</timestamp>
				<credit type="str">AFP/Getty Images</credit>
				<image_topic_relevance type="int4">10</image_topic_relevance>
				<width type="int4">2860</width>
				<height type="int4">2268</height>
				<image_id type="str">0gwb63H2Wmapg</image_id>
				<caption type="str">
					Vania King of the US (L) speaks with US team captain Zena Garrison (R) 
					during a break in her match against Kirsten Flipken of Belgium in the 
					quarter-finals round in the Fed Cup World Group 2007 between Belgium and 
					the US in Delray Beach, Florida 22 April 2007. King won the match 4-6, 
					6-4, 7-5 to give the US a total score of 3-0 and move to the next round
				</caption>
				<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>
					<source_id type="str">0a9L9fsaU55wK</source_id>
					<type type="int4">6</type>
				</source>
			</image>
		</topic>
		........
		........
	</payload>
</response>

 search_getRelatedQuotes

This method is used to retrieve quotes from articles that contain the given query term .

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getRelatedQuotes?
    accesskey=<accesskey>&signature=<signature>&query=Condoleezza+Iraq&limit=1

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    end_time Timestamp N 2007-03 <current time>
    start_time Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    limit the number of results to be returned integer N 40 10
    offset integer N 5 0
    sort flag to indicate the sorting order string N daterank, date, relevance.
    ** daterank is an option to sort by combination of date and relevance    		 daterank
    source_filter_id daylife source filter id string N 06T8a8lavf8sc None
    block_nsfw flag to indicate if content scored as obscene should be blocked integer N 1 0
    source_whitelist one or more name value pairs of Daylife source ids, used to restrict returned results to the enumerated set string N source_whitelist=0a0F0VifAodow&source_whitelist=04Ew78S3C96yc None
    source_blacklist one or more name value pairs of Daylife source ids to exclude from returned results string N source_blacklist=0a0F0VifAodow&source_blacklist=04Ew78S3C96yc None
    require_speaker flag specifying the quotes returned must be attributed (i.e., the speaker is known) integer N 0 or 1 0
    speaker_topic_id topic_ids of topics that the quotes returned must be attributed to string N name-value pairs of topic_ids None

 Sample Output

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<quote>
			<quote_id type="str">03TWezQa1M85p</quote_id>
			<timestamp_epoch type="int4">1200749352</timestamp_epoch>
			<timestamp type="str">2008-01-19 13:29:12</timestamp>
			<quote_text type="str">But we will still be friends with the 
						Americans and invite them to tea every 
						time they drive through the town
			</quote_text>
			<source>
				<name type="str">MSNBC</name>
				<url type="str">http://www.msnbc.msn.com/</url>
				<daylife_url type="str">http://www.daylife.com/source/MSNBC</daylife_url>
				<rank type="int4">1</rank>
				<source_id type="str">07yTb3kbhD6Bo</source_id>
				<type type="int4">1</type>
			</source>
			<daylife_url type="str">http://www.daylife.com/quote/03TWezQa1M85p</daylife_url>
			<article>
				<timestamp_epoch type="int4">1200749352</timestamp_epoch>
				<headline type="str">'Awakening' pacts prove complicated</headline>
				<timestamp type="str">2008-01-19 13:29:12</timestamp>
				<url type="str">http://www.msnbc.msn.com/id/22739412/</url>
				<daylife_url type="str">http://www.daylife.com/article/0baOdqcflg2hB</daylife_url>
				<article_id type="str">0baOdqcflg2hB</article_id>
			</article>
		</quote>
		........
		........
	</payload>
</response>

back to top

 search_getQuotesAbout

This method is used to retrieve quotes that mention a given query term .

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getQuotesAbout?
    accesskey=<accesskey>&signature=<signature>&query=Condoleezza&limit=1

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    end_time Timestamp N 2007-03 <current time>
    start_time Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    limit the number of results to be returned integer N 40 10
    offset integer N 5 0
    sort flag to indicate the sorting order string N daterank, date, relevance.
    ** daterank is an option to sort by combination of date and relevance    		 daterank
    source_filter_id daylife source filter id string N 06T8a8lavf8sc None
    block_nsfw flag to indicate if content scored as obscene should be blocked integer N 1 0
    source_whitelist one or more name value pairs of Daylife source ids, used to restrict returned results to the enumerated set string N source_whitelist=0a0F0VifAodow&source_whitelist=04Ew78S3C96yc None
    source_blacklist one or more name value pairs of Daylife source ids to exclude from returned results string N source_blacklist=0a0F0VifAodow&source_blacklist=04Ew78S3C96yc None
    require_speaker flag specifying the quotes returned must be attributed (i.e., the speaker is known) integer N 0 or 1 0
    speaker_topic_id topic_ids of topics that the quotes returned must be attributed to string N name-value pairs of topic_ids None

Sample Output

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<quote>
			<quote_id type="str">03TWezQa1M85p</quote_id>
			<timestamp_epoch type="int4">1200749352</timestamp_epoch>
			<timestamp type="str">2008-01-19 13:29:12</timestamp>
			<quote_text type="str">But we will still be friends with Condoleezza
						and invite them to tea every time they drive through the town
			</quote_text>
			<source>
				<name type="str">MSNBC</name>
				<url type="str">http://www.msnbc.msn.com/</url>
				<daylife_url type="str">http://www.daylife.com/source/MSNBC</daylife_url>
				<rank type="int4">1</rank>
				<source_id type="str">07yTb3kbhD6Bo</source_id>
				<type type="int4">1</type>
			</source>
			<daylife_url type="str">http://www.daylife.com/quote/03TWezQa1M85p</daylife_url>
			<article>
				<timestamp_epoch type="int4">1200749352</timestamp_epoch>
				<headline type="str">'Awakening' pacts prove complicated</headline>
				<timestamp type="str">2008-01-19 13:29:12</timestamp>
				<url type="str">http://www.msnbc.msn.com/id/22739412/</url>
				<daylife_url type="str">http://www.daylife.com/article/0baOdqcflg2hB</daylife_url>
				<article_id type="str">0baOdqcflg2hB</article_id>
			</article>
		</quote>
		........
		........
	</payload>
</response>

back to top

 search_getQuotesBy

This method is used to retrieve quotes that are said by the topic matching given query term .

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getQuotesBy?
    accesskey=<accesskey>&signature=<signature>&query=Condoleezza&limit=1

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    end_time Timestamp N 2007-03 <current time>
    start_time Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    limit the number of results to be returned integer N 40 10
    offset integer N 5 0
    sort flag to indicate the sorting order string N daterank, date, relevance.
    ** daterank is an option to sort by combination of date and relevance    		 daterank
    source_filter_id daylife source filter id string N 06T8a8lavf8sc None
    block_nsfw flag to indicate if content scored as obscene should be blocked integer N 1 0
    source_whitelist one or more name value pairs of Daylife source ids, used to restrict returned results to the enumerated set string N source_whitelist=0a0F0VifAodow&source_whitelist=04Ew78S3C96yc None
    source_blacklist one or more name value pairs of Daylife source ids to exclude from returned results string N source_blacklist=0a0F0VifAodow&source_blacklist=04Ew78S3C96yc None

Sample Output

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<quote>
			<quote_id type="str">03TWezQa1M85p</quote_id>
			<timestamp_epoch type="int4">1200749352</timestamp_epoch>
			<timestamp type="str">2008-01-19 13:29:12</timestamp>
			<quote_text type="str">But we will still be friends with Condoleezza
						and invite them to tea every time they drive through the town
			</quote_text>
			<source>
				<name type="str">MSNBC</name>
				<url type="str">http://www.msnbc.msn.com/</url>
				<daylife_url type="str">http://www.daylife.com/source/MSNBC</daylife_url>
				<rank type="int4">1</rank>
				<source_id type="str">07yTb3kbhD6Bo</source_id>
				<type type="int4">1</type>
			</source>
			<daylife_url type="str">http://www.daylife.com/quote/03TWezQa1M85p</daylife_url>
			<article>
				<timestamp_epoch type="int4">1200749352</timestamp_epoch>
				<headline type="str">'Awakening' pacts prove complicated</headline>
				<timestamp type="str">2008-01-19 13:29:12</timestamp>
				<url type="str">http://www.msnbc.msn.com/id/22739412/</url>
				<daylife_url type="str">http://www.daylife.com/article/0baOdqcflg2hB</daylife_url>
				<article_id type="str">0baOdqcflg2hB</article_id>
			</article>
		</quote>
		........
		........
	</payload>
</response>

back to top

 search_getRelatedImages

This method is used to retrieve images related to articles that contain the given query term  

You need a license to photos from Getty Images, Associated Press AND/OR Reuters Pictures in order to get back images through this API. Please email developer@daylife.com for more information on image licensing.

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getRelatedImages?
    accesskey=<accesskey>&signature=<signature>&query=Condoleezza+Iraq&limit=2

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    end_time Timestamp N 2007-09-24 00:00:00 <current time>
    start_time Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    limit the number of results to be returned integer N 40 10
    offset integer N 5 0
    sort flag to indicate the sorting order string N daterank, date, relevance.
    ** daterank is an option to sort by combination of date and relevance    		 daterank
    source_filter_id daylife source filter id string N 06T8a8lavf8sc None

 Sample Output

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<image>
			<url type="str">http://cache.daylife.com/imageserve/0dDR845cPSa7m/610x.jpg</url>
			<daylife_url type="str">http://cache.daylife.com/imageserve/0dDR845cPSa7m/340x.jpg</daylife_url>
			<thumb_url type="str">http://cache.daylife.com/imageserve/0dDR845cPSa7m/45x45.jpg</thumb_url>
			<timestamp_epoch type="int4">1200582120</timestamp_epoch>
			<timestamp type="str">2008-01-17 15:02:00</timestamp>
			<image_id type="str">0dDR845cPSa7m</image_id>
			<image_topic_relevance type="int4">10</image_topic_relevance>
			<width type="int4">3000</width>
			<height type="int4">1915</height>
			<caption type="str">
				US President George W. Bush (C) meets with the Special Envoy for Sudan, 
				Richard Williamson (L) and Secretary of State Condoleezza Rice (R), in the Oval 
				Office at the White House in Washington, DC, 17 January 2008.
			</caption>
			<credit type="str">AFP/Getty Images</credit>
			<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>
				<source_id type="str">0a9L9fsaU55wK</source_id>
				<type type="int4">6</type>
			</source>
		</image>
		....
		....
	</payload>
</response>

back to top

 search_getCounts

This method is used to retrieve number of mentions in news for the given query

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getCounts?
    accesskey=<accesskey>&signature=<signature>&query=Condoleezza

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    end_time   Timestamp N 2007-03 <current time>
    start_time   Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    source_filter_id string N
    		None None
    source_whitelist one or more name value pairs of Daylife source ids string N source_whitelist=0a0F0VifAodow&source_whitelist=04Ew78S3C96yc  
Sample Output:
<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
		<count type="int4">1232</count>
	</payload>
</response>

back to top

 search_getRelatedVideos

This method is used to retrieve videos that contain the given query term. We do not stream video or have a video player. Instead, we return a link back to the publisher's website where the video can be played.  

Sample Invocation

    http://freeapi.daylife.com/xmlrest/publicapi/4.10/search_getRelatedVideos?
    accesskey=<accesskey>&signature=<signature>&query=Condoleezza+Iraq&limit=2

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
    query the search term string Y "Iraq war". A query can be compsed of a maximum of 32 terms combined using logical operators. N/A
    end_time Timestamp N 2007-09-24 00:00:00 <current time>
    start_time Timestamp N 2007-05-03 09:00:00, 1178182800 <end_time minus 1 month>
    limit the number of results to be returned integer N 40 10
    offset integer N 5 0
    sort flag to indicate the sorting order string N daterank, date, relevance.
    ** daterank is an option to sort by combination of date and relevance    		 daterank
    source_filter_id daylife source filter id string N 06T8a8lavf8sc None
    source_whitelist one or more name value pairs of Daylife source ids string N source_whitelist=0a0F0VifAodow&source_whitelist=04Ew78S3C96yc None
    source_blacklist one or more name value pairs of Daylife source ids to exclude from returned results string N source_blacklist=0a0F0VifAodow&source_blacklist=04Ew78S3C96yc None

 Sample Output

<response>
	<message type="str">Success</message>
	<code type="int4">2001</code>
	<payload>
    
    
    
        <video>
    <thumb_url type="str">http://cache.daylife.com/imageserve/01ys5SO1j0ggc/120x90.jpg</thumb_url>
    <timestamp_epoch type="int4">1338420540</timestamp_epoch>
    <search_score type="float">2.01303056688</search_score>
    <headline type="str">Carney: Obama Has "Strong Case" Of "Responsible Stewardship Of Our Budget And Our Fiscal Issues"</headline>
    <timestamp type="str">2012-05-30 23:29:00</timestamp>
    <video_id type="str">01ys5SO1j0ggc</video_id>
    <content_url type="str">http://images.rcp.realclearpolitics.com/140026_1_.jpg</content_url>
    <credit type="str"/>
    <source>
        <name type="str">Real Clear Politics</name>
        <url type="str">http://www.realclearpolitics.com/blog/</url>
        <daylife_url type="str">http://www.daylife.com/source/Real_Clear_Politics</daylife_url>
        <rank type="int4">3</rank>
        <favicon_url type="str">http://favicon.daylife.com/imageserve/0gqScxf7BT8E1/favicon.png</favicon_url>
        <source_id type="str">0gqScxf7BT8E1</source_id>
        <type type="str">MAINSTREAM</type>
    </source>
    <content_type type="str">image/jpeg</content_type>
    <caption type="str">White House press secretary Jay Carney uses a questioned Market Watch report about spending under Obama to claim he has been a "responsible steward" of the economy. 
        
        Carney also made a surprising claim that President Obama will produce a surplus for his successor if he is given a second term.
        
        "Now, and I know the RNC likes to put this stuff out and contesting it and they cited the size of the budget deficit in 2009, 2010, and 2011 and the fact that they were among the largest in history. Well, of course they were, because what they never tell you is that President Obama was handed, on January 20, 2009, the single largest budget deficit in history and what they never tell you is that, unlike what will happen when President Obama leaves office, in four and a half years, the deficit that was handed to him in January of 2009 began as a surplus eight years earlier," Carney said at the press briefing today.
        
        "That is not something you hear the RNC talk about. and so when it comes to responsible stewardship of our budget and fiscal issues, i think we have a strong case," he said.</caption>
    <page_url type="str">http://www.realclearpolitics.com/video/2012/05/30/carney_obama_has_strong_case_of_responsible_stewardship_of_our_budget_and_our_fiscal_issues.html</page_url>
		</video>
    
		....
		....
	</payload>
</response>

back to top