
In the DayPI, quotes are things people have said (not stock quotes!). When the Daylife system can determine who said the quote, the quote is assigned an attribution. The quote API method calls return articles, quotes, images and topics for a given quote.
This
function returns basic information for a quote.
http://freeapi.daylife.com
accesskey=<accesskey>&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 | |
| quote_id | The quote id | string | Y | 0ak0fu91Rr3km | N/A |
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>
<query_term type="str">07vgers9mJayf</query_term>
<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>
This method is used to retrieve articles that are related to the article that contains the given quote.
Sample Invocation
http://freeapi.daylife.com
accesskey=<accesskey>&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 | |
| quote_id | The quote id | String | Y | 03cV5zI2fk03s | 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 | date, relevance | date |
| source_filter_id | daylife source filter id | string | N | 06T8a8lavf8sc | None |
| include_image | Flag to indicate if one related scraped image be returned if available. | 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 |
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>
</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>
<query_term type="str">07vgers9mJayf</query_term>
<daylife_url type="str">http://www.daylife.com/article/03j9fqr8kkb6B</daylife_url>
<article_id type="str">03j9fqr8kkb6B</article_id>
</article>
........
........
</payload>
</response>
This method is used to retrieve quotes from articles that are related to the article containing the given quote.
Sample Invocation
http://freeapi.daylife.com
accesskey=<accesskey>&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 | |
| quote_id | The quote id | string | Y | 03cV5zI2fk03s | 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 | date, relevance | date |
| source_filter_id | daylife source filter id | string | N | 06T8a8lavf8sc | None |
| require_speaker | flag specifying the quotes returned must be attributed | integer | N | 0 or 1 | 0 |
| speaker_topic_id | topic_ids of topics that the quotes returned must be attributed to | string | N | Comma separated list of topic_ids for topics | 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>
<query_term type="str">07vgers9mJayf</query_term>
<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>
This
method is used to retrieve topics from articles that are related to the
article containing the given quote.
Sample Invocation
http://freeapi.daylife.com
accesskey=<accesskey>&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 | |
| quote_id | The quote id | string | Y | 03cV5zI2fk03s | 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 To be implemented in future. | string | N | date, relevance | date |
| source_filter_id | daylife source filter id | string | N | 06T8a8lavf8sc | None |
| include_topic_type | A comma separated list of types of topics that should be returned | string | N | person or place or organization or a comma separated list of any of their combinations | person,place,organization |
| 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>
<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>