The Diana News and Analysis API provides a representative sample of news and media coverage for almost all topics. It includes API access points which can be used for a number of purposes, including positive and negative financail event detection, temporal sentiment and tone tracking, and general news querying.
Users should start their search by querying the /dates
access point, which provides a list of dates where the search term has one or more search results.
/dates/yyyymm/search-term
The /dates
API returns a serialized JSON string:
[{"Year":"2019","Month":"01,"Day":"01","Search String":"20151001"},{"Year":"2019","Month":"01","Day":"02","Search String":"20151002"}, ...]
The value in ‘Search String’ should then be entered into either the /counts
or /articles
access points.
The /counts
API provides an aggregated count of all article matches on either a daily, hourly, or per-minute level. This is particularly useful for tracking current and historical changes in overall media coverage.
/counts/daily or hourly or monthly/yyyymmdd/search-term
The /counts
API returns a serialized JSON string:
[{"Year":"2019","Month":"01","Day":"01","Number of Articles":"10"}, ...]
The /articles
API provides financial and general language scores along with article links for up to four search terms. This is useful for tracking current and historical changes in media coverage tone and is particularly popular for financial event identification and trends.
/articles/yyyymmdd/search-term/search-term/search-term/search-term
Search terms are treated as AND keywords, e.g., Private AND Equity.
The /articles
API returns a serialized JSON string:
[{"URL":"https://...","Tone":{"Overall Tone":"0.03","Financial":"1","Financial Positive":"1","Financial Negative":"0","Litigious":"1","Power":"1"},"Word Count":"82"}, ...]
Overall tone is scaled from +20 to -20, although observations above +1 and -1 are generally rare.
Financial is scored from 0 to +1, while financial positive and negative scores have an unrestricted range.
Litigious, which measures whether an article refers to a litigious event, is unbounded.
Power, which measures the frequency of a works which invoke power or dominance, is also unbounded.