How to make a request

Request Data

https://www.act-analytics.com/app/news-api/request_data/<api_key>/<permids>/<esg_categories>

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.

“article_links” 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.

“fast_scores” is an array of ratings (smoothed by a weighted moving average over a small number of trailing articles) that correspond to “article_links” 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 “article_links” and the indicated company permID.

“time_published” is an array of Unix timestamps that correspond to the times the articles in “article_links” were published.

“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 time_published 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.

Unix timestamps of time entered in database (similar to “time_published”) are available.

Example Request

curl --request GET https://www.act-analytics.com/app/news-api/request_data/133713371337/4295905494,5037473967/labor

Example Response

  • {
    • "5037473967" : {
      • "fast_scores" : [
        • 57.871666666666655 ,
        • 52.66721751412429 ,
        • 52.33428639846743 ,
        • 51.83129385964913 ,
        • 49.252264880952374 ,
        • 48.79274067952249 ,
        • 48.79274067952249
      • ],
      • "scores" : [
        • 57.87166666666666 ,
        • 52.74365076367909 ,
        • 52.39684535822402 ,
        • 51.90212577940681 ,
        • 49.46336279972982 ,
        • 49.008905768343325 ,
        • 50.26587068035389
      • ],
      • "momentum" : [
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0
      • ],
      • "volume" : [
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0
      • ],
      • "time_published" : [
        • 1604956740 ,
        • 1605453126 ,
        • 1606141380 ,
        • 1606147028 ,
        • 1606257900 ,
        • 1606385082 ,
        • 1606401120
      • ],
      • "article_links" : [
        • "https://www.smh.com.au/business/business/workplace/food-delivery-riders-deserve-better-rights-at-work-20201110-p56dbj.html" ,
        • "https://www.cnn.com/2020/11/15/tech/gig-worker-classification-post-prop-22/index.html" ,
        • "https://www.reuters.com/article/us-lyft-uber-contract-idUSKBN2831S5" ,
        • "http://techcrunch.com/2020/11/23/former-sequoia-partner-amy-sun-has-already-raised-millions-for-her-stealthy-startup/" ,
        • "https://www.smh.com.au//topic/national/spate-of-rider-deaths-a-tragedy-uber-chief-executive-20201125-p56hz4.html" ,
        • "https://www.aljazeera.com/opinions/2020/11/26/gig-economy-uk/" ,
        • "https://www.businessinsider.com/leaked-uber-employee-handbook-travis-kalanick-dara-khosrowshahi-2020-11"
      • ],
      • "article_titles" : [
        • "Food delivery riders deserve better rights at work" ,
        • "After $200 million California brawl, Uber and Lyft's gig worker fight is far from over" ,
        • "U.S. federal government awards transportation contract to Uber, Lyft - Reuters" ,
        • "Former Sequoia Partner Amy Sun has already raised millions for her stealthy startup" ,
        • "Spate of rider deaths a 'tragedy': Uber chief executive" ,
        • "It's time for the UK government to hear the plight of gig workers" ,
        • "A leaked copy of Uber's employee handbook reveals how the ride-hailing giant has grown up since Travis Kalanick joked about not being able to sleep with employees (UBER)"
      • ]
    • },
    • "4295905494" : {
      • "fast_scores" : [
        • 51.23061363636363 ,
        • 39.208655128769536 ,
        • 38.21828558257158 ,
        • 39.53344616052163 ,
        • 41.09557464531267 ,
        • 39.063225340880145 ,
        • 40.39288048754856
      • ],
      • "scores" : [
        • 51.23061363636363 ,
        • 39.38521124985286 ,
        • 38.36930670836356 ,
        • 39.59254598342462 ,
        • 41.0522051190689 ,
        • 39.17625240037409 ,
        • 40.3748369582643
      • ],
      • "momentum" : [
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0
      • ],
      • "volume" : [
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0 ,
        • 0
      • ],
      • "time_published" : [
        • 1605052800 ,
        • 1605212315 ,
        • 1605214440 ,
        • 1605218134 ,
        • 1605269062 ,
        • 1605289560 ,
        • 1605289944
      • ],
      • "article_links" : [
        • "http://www.bnnbloomberg.ca/amazon-lures-food-stamp-shoppers-as-online-buying-surges-50-fold-1.1520822" ,
        • "http://techcrunch.com/2020/11/12/amazon-faces-lawsuit-alleging-failure-to-provide-ppe-to-workers-during-pandemic/" ,
        • "https://www.reuters.com/article/us-health-coronavirus-amazon-com-lawsuit-idUSKBN27S34E" ,
        • "https://www.aljazeera.com/economy/2020/11/12/former-amazon-com-employee-sues-over-covid-worker-safety-issues" ,
        • "https://www.businessinsider.com/how-to-nail-amazon-interview-according-to-senior-former-recruiter-2020-11" ,
        • "https://www.theverge.com/2020/11/13/21563996/amazon-organizer-racial-discrimination-lawsuit-warehouse-fulfillment-center" ,
        • "https://www.businessinsider.com/amazon-hr-boss-shares-thoughts-on-permanent-remote-working-2020-11"
      • ],
      • "article_titles" : [
        • "Amazon Lures Food-Stamp Shoppers as Online Buying Surges 50-Fold - BNN Bloomberg" ,
        • "Amazon faces lawsuit alleging failure to provide PPE to workers during pandemic" ,
        • "Fired Amazon worker files discrimination lawsuit over pandemic conditions - Reuters Africa" ,
        • "Former Amazon.com employee sues over COVID worker safety issues" ,
        • "How to use the 'CAR' method to nail Amazon's behavioral interview questions, according to a former senior recruiter" ,
        • "An Amazon warehouse organizer is suing the company for racial discrimination" ,
        • "In a leaked recording, Amazon's HR boss told employees why the company hasn't rushed into permanent remote working: 'We are learning as we go' (AMZN)"
      • ]
    • }
  • }

Supported Companies

https://www.act-analytics.com/app/news-api/companies_in_db/<api_key>

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

Example Request

Copy

curl --request GET https://www.act-analytics.com/app/news-api/companies_in_db/133713371337

Example Response

  • {
    • "0" : {
      • "primary ric" : "8TRA.DE" ,
      • "company name" : "TRATON SE" ,
      • "permid" : "5068663280"
    • },
    • "1" : {
      • "primary ric" : "OWG_p.DE" ,
      • "company name" : "Volkswagen AG" ,
      • "permid" : "4295869244"
    • },
    • "2" : {
      • "primary ric" : "HON.N" ,
      • "company name" : "HONEYWELL INTERNATIONAL INC." ,
      • "permid" : "4295912155"
    • },
    • "3" : {
      • "primary ric" : "CLX.N" ,
      • "company name" : "THE CLOROX COMPANY" ,
      • "permid" : "4295903733"
    • },
    • "4" : {
      • "primary ric" : "VG.OQ" ,
      • "company name" : "VONAGE HOLDINGS CORP." ,
      • "permid" : "4295916135"
    • },
    • "5" : {
      • "primary ric" : "EL.N" ,
      • "company name" : "THE ESTEE LAUDER COMPANIES INC." ,
      • "permid" : "4295903171"
    • },
    • "6" : {
      • "primary ric" : "CVX.N" ,
      • "company name" : "CHEVRON CORPORATION" ,
      • "permid" : "4295903744"
    • },
    • "7" : {
      • "primary ric" : "WLTW.OQ" ,
      • "company name" : "Willis Towers Watson Public Limited Company" ,
      • "permid" : "4295899509"
    • },
    • "8" : {
      • "primary ric" : "JPM.N" ,
      • "company name" : "JPMORGAN CHASE & CO." ,
      • "permid" : "5000021791"
    • },
    • "9" : {
      • "primary ric" : "XOM.N" ,
      • "company name" : "EXXON MOBIL CORPORATION" ,
      • "permid" : "4295912121"
    • },
    • "10" : {
      • "primary ric" : "AGN.N" ,
      • "company name" : "Allergan plc" ,
      • "permid" : "5040050523"
    • },
    • "..."
  • }

ESG Categories

https://www.act-analytics.com/app/news-api/esg_categories_in_db/<api_key>

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

Example Request

Copy

curl --request GET https://www.act-analytics.com/app/news-api/esg_categories_in_db/133713371337

Example Response

  • {
    • "0" : {
      • "category_name" "labor"
      },
    • "1" : {
      • "category_name" "pollution"
      },
    • "2" : {
      • "category_name" "diversity"
      },
    • "3" : {
      • "category_name" "nature"
      },
    • "4" : {
      • "category_name" "water"
      },
    • "5" : {
      • "category_name" "human_rights"
      },
    • "6" : {
      • "category_name" "health"
      },
    • "7" : {
      • "category_name" "legal"
      },
    • "8" : {
      • "category_name" "business"
      }
  • }
Previous
What is Act Analytics API?

Table of contents