How to make a request

Company Data

https://www.act-analytics.com/news-api/company-data?api-key=apiKey&permids=id1,id2,...&esg-categories=cat1,cat2,...

Returns time series data on the requested ESG categories and company permIDs.

Notice that the “Request Data” endpoint can accept a comma-separated list of company permIDs. It can also accept a comma-separated list of ESG categories.

“articleLinks” is an array of URLs of the articles in our database that are relevant to the indicated company permID (the parent object name) and any of the requested ESG categories.

“fastScores” is an array of ratings (smoothed by a weighted moving average over a small number of trailing articles) that correspond to “articleLinks” and the indicated company permID.

“scores” is an array of ratings (smoothed by a weighted moving average over a large number of trailing articles) that correspond to “articleLinks” and the indicated company permID.

“processedTime” is an array of Unix timestamps that correspond to the times the articles in “articleLinks” were processed by Act Analytics and available through the API.

“momentum” is an array of values that indicate the rate of change in scores over the trailing fifteen articles.

“volume” is an array of values that indicate the number of articles per day, extrapolated from the average difference in processedTime over the trailing twenty-five articles.


Notes:

Some articles speak favorably about one company and unfavorably about another. Our algorithms understand syntactic dependency, homographs, parts of speech, and other important grammatical nuances. Two companies may be assigned different scores on the same article.

Content of an article at a URL is not always static; it may be updated/corrected after publishing. Scores are computed from article content at time of processing. Occasionally, a news outlet will distribute the same article on multiple domains. We may process an article, then find an updated/edited version of it on a different domain at a later time. If the content of the updated/edited article is changed significantly, we’ll treat it as a new article and give it its own score.

Example Request
curl --request GET https://www.act-analytics.com/news-api/company-data?api-key=133713371337&permids=4295905494&esg-categories=labor,health
Example Response
{
	"4295905494": [
		{
			"permId": "4295905494",
			"processedTime": 1606934050,
			"articleTitle": "AWS Panorama adds employee monitoring power to workplace cameras",
			"articleLink": "https://www.bbc.co.uk/news/technology-55158319",
			"score": 52.25561268232366,
			"fastScore": 53.243869878141446,
			"momentum": 0.6155763888888889,
			"volume": 4.0829024521830215
		},
		{
			"permId": "4295905494",
			"processedTime": 1606940372,
			"articleTitle": "Washington state to boost workers' comp rates for Amazon",
			"articleLink": "https://abcnews.go.com/Business/wireStory/washington-state-boost-workers-comp-rates-amazon-74509864",
			"score": 52.32045982326067,
			"fastScore": 52.997910944259836,
			"momentum": -0.897380036630036,
			"volume": 4.107537616772445
		},
		{
			"permId": "4295905494",
			"processedTime": 1607011200,
			"articleTitle": "'Amazon's days of impunity are over': 400 international lawmakers including Ilhan Omar and Rashida Tlaib slam Jeff Bezos on wages, climate action, and taxes",
			"articleLink": "https://www.businessinsider.com/amazons-days-of-impunity-over-400-lawmakers-tell-bezos-2020-12",
			"score": 52184758846827044,
			"fastScore": 52.38710722192154,
			"momentum": 0.11682623906705558,
			"volume": 3.611134330853465
		},
		{
			"permId": "4295905494",
			"processedTime": 1607021909,
			"articleTitle": "Amazon to employ 500 at new Oklahoma City fulfillment center",
			"articleLink": "https://apnews.com/c0144bd235b4cebc5e1540eddeca0ad9",
			"score": 52.2398997288166,
			"fastScore": 52.261446711979296,
			"momentum": -0.8803581780538293,
			"volume": 3.608350575202683
		},
		{
			"permId": "4295905494",
			"processedTime": 1607041156,
			"articleTitle": "Amazon workers in bid to unionize at Alabama warehouse",
			"articleLink": "https://apnews.com/47908de686f774580897975f6123e2a1",
			"score": 52.20878712184946,
			"fastScore": 51.83599023907411,
			"momentum": 0.2223714285714285,
			"volume": 3.6110337141264974
		},
		{
			"permId": "4295905494",
			"processedTime": 1607041170,
			"articleTitle": "Amazon workers in bid to unionize at Alabama warehouse",
			"articleLink": "https://abcnews.go.com/Technology/wireStory/amazon-workers-bid-unionize-alabama-warehouse-74528894",
			"score": 52.29431503828252,
			"fastScore": 52.187579988391136,
			"momentum": 1.3324043956043958,
			"volume": 3.696665228599239
		},
		{
			"permId": "4295905494",
			"processedTime": 1607062484,
			"articleTitle": "Amazon workers in bid to unionize at Alabama warehouse",
			"articleLink": "https://www.thehindu.com/news/international/amazon-workers-in-bid-to-unionize-at-alabama-warehouse/article33246893.ece",
			"score": 52.37688704883944,
			"fastScore": 52.239386034004454,
			"momentum": 0.7646148028442151,
			"volume": 3.563204959893324
		},
		{
			"permId": "4295905494",
			"processedTime": 1607077295,
			"articleTitle": "Rashida Tlaib accuses Amazon of profiting during the pandemic while neglecting workers. Staff are 'afraid to go to work' because Amazon's facilities aren't clean she said.",
			"articleLink": "https://www.businessinsider.com/rashida-tlaib-amazon-jeff-bezos-workers-taxes-warehouses-covid-clean-2020-12",
			"score": 52.09071101046996,
			"fastScore": 51.05162785739556,
			"momentum": -1.1590553161592503,
			"volume": 3.4800179237034268
		},
		{
			"permId": "4295905494",
			"processedTime": 1607114588,
			"articleTitle": "Amazon to face federal lawsuit over firing of warehouse worker",
			"articleLink": "https://www.theverge.com/2020/12/4/22153797/amazon-lawsuit-labor-laws-firing-warehouse-worker-courtney-bowden",
			"score": 51.82242563835735,
			"fastScore": 50.05298732523111,
			"momentum": -0.9633269230769227,
			"volume": 3.3025839661587075
		},
		{
			"permId": "4295905494",
			"processedTime": 1607144925,
			"articleTitle": "Amazon has reportedly been accused by the NLRB of illegally threatening and firing a worker who pushed for sick pay",
			"articleLink": "https://www.businessinsider.com/amazon-nlrb-complaint-alleges-illegally-fired-worker-sick-pay-dispute-2020-12",
			"score": 51.21039861632099,
			"fastScore": 47.90640322581519,
			"momentum": -1.8903812030075187,
			"volume": 3.1555159898650964
		},
		{
			"permId": "4295905494",
			"processedTime": 1607185800,
			"articleTitle": "Fired Amazon worker gets a court hearing over retaliation claims",
			"articleLink": "https://www.engadget.com/amazon-nlrb-court-hearing-over-worker-retaliation-163011405.html",
			"score": 50.9932110261084,
			"fastScore": 47.22899362293993,
			"momentum": -1.4757475961538462,
			"volume": 2.975257838461406
		},
		{
			"permId": "4295905494",
			"processedTime": 1607185811,
			"articleTitle": "Fired Amazon worker gets a court hearing over retaliation claims",
			"articleLink": "https://www.businessinsider.com/amazon-ceo-jeff-bezos-returns-to-daily-oversight-of-the-company-2020-12",
			"score": 50.490287598081515,
			"fastScore": 45.65032745316325,
			"momentum": -1.7254945054945054,
			"volume": 3.008766864097646
		},
		{
			"permId": "4295905494",
			"processedTime": 1607889976,
			"articleTitle": "Jeff Bezos is back in the trenches at Amazon. Insiders describe working with a more deeply-involved CEO. (AMZN)",
			"articleLink": "http://www.bnnbloomberg.ca/california-targets-amazon-over-virus-worker-safety-protocols-1.1536369",
			"score": 50.52517386498694,
			"fastScore": 45.725431468571756,
			"momentum": -0.1088531746031747,
			"volume": 1.5809517274505094
		},
		...
	]
}

Supported Companies

https://www.act-analytics.com/news-api/all-companies?api-key=apiKey

The “Request Data” endpoint accepts any of the “permid” identifiers.

Example Request
curl --request GET https://www.act-analytics.com/news-api/all-companies?api-key=133713371337
Example Response
[
	{
		"primaryRic": "8TRA.DE",
		"companyName": "TRATON SE",
		"permId": "5068663280"
	},
	{
		"primaryRic": "OWG_p.DE",
		"companyName": "Volkswagen AG",
		"permId": "4295869244"
	},
	{
		"primaryRic": "HON.N",
		"companyName": "HONEYWELL INTERNATIONAL INC.",
		"permId": "4295912155"
	},
	{
		"primaryRic": "CLX.N",
		"companyName": "THE CLOROX COMPANY",
		"permId": "4295903733"
	},
	{
		"primaryRic": "VG.OQ",
		"companyName": "VONAGE HOLDINGS CORP.",
		"permId": "4295916135"
	},
	{
		"primaryRic": "EL.N",
		"companyName": "THE ESTEE LAUDER COMPANIES INC.",
		"permId": "4295903171"
	},
	{
		"primaryRic": "CVX.N",
		"companyName": "CHEVRON CORPORATION",
		"permId": "4295903744"
	},
	{
		"primaryRic": "WLTW.OQ",
		"companyName": "Willis Towers Watson Public Limited Company",
		"permId": "4295899509"
	},
	{
		"primaryRic": "JPM.N",
		"companyName": "JPMORGAN CHASE & CO.",
		"permId": "5000021791"
	},
	{
		"primaryRic": "XOM.N",
		"companyName": "EXXON MOBIL CORPORATION",
		"permId": "4295912121"
	},
	{
		"primaryRic": "AGN.N",
		"companyName": "Allergan plc",
		"permId": "5040050523"
	},
	...
]

ESG Categories

https://www.act-analytics.com/news-api/esg-categories?api-key=apiKey

The “Request Data” endpoint accepts any of the “category name” identifiers.

Example Request
curl --request GET https://www.act-analytics.com/news-api/esg-categories?api-key=133713371337
Example Response
[
	"labor",
	"pollution",
	"diversity",
	"nature",
	"water",
	"human_rights",
	"health",
	"legal",
	"business"
]

Company Events

https://www.act-analytics.com/news-api/company-events?api-key=apiKey&permids=id1,id2,...&esg-categories=cat1,cat2,...&start-time=unix&end-time=unix

Returns a list of significant news events – for each of the requested company PermIDs, for all the requested ESG categories, within the requested time range.

Example Request
curl --request GET https://www.act-analytics.com/news-api/company-events?api-key=133713371337&permids=4297297477&esg-categories=legal&start-time=0&end-time=2000000000
Example Response
{
	"4297297477": [
		{
			"permId": "4297297477",
			"eventTitle": "Zuckerberg says Bannon has not violated enough policies for suspension - recording - Reuters India",
			"eventLink": "https://in.reuters.com/article/uk-usa-election-facebook-idINKBN27S35C",
			"earliestArticleTime": 1605188160,
			"latestArticleTime": 1605217941,
			"score": 44.628770833333334,
			"articles": [
				{
					"articleTitle": "Zuckerberg says Bannon has not violated enough policies for suspension - recording - Reuters India",
					"articleLink": "https://in.reuters.com/article/uk-usa-election-facebook-idINKBN27S35C"
				},
				{
					"articleTitle": "Zuckerberg defends not suspending ex-Trump aide Bannon from Facebook: recording",
					"articleLink": "https://www.smh.com.au/world/world/north-america/zuckerberg-defends-not-suspending-ex-trump-aide-bannon-from-facebook-recording-20201113-p56ebg.html"
				}
			]
		},
		{
			"permId": "4297297477",
			"eventTitle": "Facebook, Twitter CEOs to be pressed on election handling",
			"eventLink": "https://toronto.citynews.ca/2020/11/16/facebook-twitter-ceos-to-be-pressed-on-election-handling/",
			"earliestArticleTime": 1605538440,
			"latestArticleTime": 1605595129,
			"score": 39.8520032497595,
			"articles": [
				{
					"articleTitle": "Facebook, Twitter CEOs facing questions on election measures",
					"articleLink": "https://abcnews.go.com/Business/wireStory/facebook-twitter-ceos-facing-questions-election-measures-74246850"
				},
				{
					"articleTitle": "Facebook, Twitter CEOs to be pressed on election handling",
					"articleLink": "https://abcnews.go.com/Business/wireStory/facebook-twitter-ceos-pressed-election-handling-74235716"
				},
				{
					"articleTitle": "Facebook, Twitter CEOs to be pressed on election handling",
					"articleLink": "https://toronto.citynews.ca/2020/11/16/facebook-twitter-ceos-to-be-pressed-on-election-handling/"
				},
				{
					"articleTitle": "Facebook, Twitter CEOs back in Congress hot seat over US election",
					"articleLink": "https://www.aljazeera.com/economy/2020/11/16/facebook-twitter-ceos-back-in-congress-hot-seat-over-us-election"
				},
				{
					"articleTitle": "Facebook, Twitter CEOs to be pressed on U.S. election handling",
					"articleLink": "https://www.ctvnews.ca/world/america-votes/facebook-twitter-ceos-to-be-pressed-on-u-s-election-handling-1.5191199"
				},
				...
			]
		},
		...
	]
}
Previous page « What is Act Analytics API?