API: Enhanced Value Screens

Replace traditional screens with our enhanced screens, which capture proprietary data found only in the footnotes and Management Discussion & Analysis sections of financial filings. Updated daily.

API: Enhanced Value Screens: Single Datapoint

Endpoint
URL
Method
/screens/enhanced/:ticker
GET
URL Parameters
Name
Description
Example
:ticker
Ticker of the stock. You can use the coverage endpoint to get full lists of options.
AAPL
Query Parameters
Name
Required
Description
Example
:datapoint
Required
Name of data point. Click here for a full list of available data points
NOPAT
:year
Required
Fiscal year of the data point. We generally cover companies back to the first digital document filed with the SEC.
2017
:quarter
Optional
Fiscal quarter Options:
Omit for annual data
1 = Q1 quarterly data
2 = Q2 quarterly data
3 = Q3 quarterly data
4 = Q4 quarterly data
1
:ttm
Optional
Trailing twelve months (TTM) data Options:
Omit for annual data
1 = TTM data ending with Q1 (indicated fiscal year Q1 + prior fiscal year Q4, Q3, & Q2)
2 = TTM data ending with Q2 (indicated fiscal year Q2 & Q1 + prior fiscal year Q4 & Q3)
3 = TTM data ending with Q3 (indicated fiscal year Q3, Q2, & Q1 + prior fiscal year Q4)
4 = TTM data ending with Q4 (indicated fiscal year Q4, Q3, Q2, & Q1).
1
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
ticker
Ticker of the listed security.
AAPL
year
Fiscal year of the data value.
2015
period
Period of the requested data; 1-4 indicate quarterly or TTM periods and 5 indicates an annual period.
5
periodtype
Period type of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
periodstring
Period string of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
datapoint
Name of data point.
NOPAT
datavalue
Value of the requested datapoint in ones.
52716962727.16620000000000000
filingtype
Type of filing the datapoint is from.
10-K
Sample Call:
Check out Python examples and more in our GitHub repo.
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/screens/enhanced/AAPL?datapoint=NOPAT&year=2015'
Success Response: 

{
  "statusCode": 200,
  "headers": {"Content-Type": "application/json"},
  "body": {
    "results": [
      {
        "ticker": "AAPL",
        "year": 2015,
        "period": 5,
        "periodtype": "ANNUAL",
        "periodstring": "ANNUAL",
        "datapoint": "NOPAT",
        "datavalue": "52716962727.16620000000000000",
      "filingtype": "10-K"
      }
    ]
  }
}

API: Enhanced Value Screens: All Datapoints

Endpoint
URL
Method
/screens/enhanced/:ticker
GET
URL Parameters
Name
Description
Example
:ticker
Ticker of the stock. You can use the coverage endpoint to get full lists of options.
AAPL
Query Parameters
Name
Required
Description
Example
:year
Required
Fiscal year of the data point. We generally cover companies back to the first digital document filed with the SEC.
2015
:quarter
Optional
Fiscal quarter Options:
Omit for annual data
1 = Q1 quarterly data
2 = Q2 quarterly data
3 = Q3 quarterly data
4 = Q4 quarterly data
1
:ttm
Optional
Trailing twelve months (TTM) data Options:
Omit for annual data
1 = TTM data ending with Q1 (indicated fiscal year Q1 + prior fiscal year Q4, Q3, & Q2)
2 = TTM data ending with Q2 (indicated fiscal year Q2 & Q1 + prior fiscal year Q4 & Q3)
3 = TTM data ending with Q3 (indicated fiscal year Q3, Q2, & Q1 + prior fiscal year Q4)
4 = TTM data ending with Q4 (indicated fiscal year Q4, Q3, Q2, & Q1).
1
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
ticker
Ticker of the listed security.
AAPL
year
Fiscal year of the data value.
2015
period
Period of the requested data; 1-4 indicate quarterly or TTM periods and 5 indicates an annual period.
5
periodtype
Period type of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
periodstring
Period string of the requested data (ANNUAL, QUARTERLY, or TTM)
ANNUAL
datapoint
Name of data point.
NOPAT
datavalue
Value of the datapoint in ones.
52716962727.16620000000000000
filingtype
Type of filing the datapoint is from.
10-K
Sample Call:
Check out Python examples and more in our GitHub repo.
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/metrics/roic/AAPL?year=2015'
Success Response: 

{
  "statusCode": 200,
  "headers": {"Content-Type": "application/json"},
  "body": {
    "results": [
      {
        "ticker": "AAPL",
        "year": 2015,
        "period": 5,
        "periodtype": "ANNUAL",
        "periodstring": "ANNUAL",
        "datapoint": "NOPAT",
        "datavalue": "52716962727.16620000000000000",
      "filingtype": "10-K"
      },
      {
        "ticker": "AAPL",
        "year": 2015,
        "period": 5,
        "periodtype": "ANNUAL",
        "periodstring": "ANNUAL",
        "datapoint": "ROIC",
        "datavalue": "2.96867114526281000",
      "filingtype": "10-K"
      },
      ...
    ]
  }
}

Datapoints

Name
Description
Datapoint
Average Invested Capital
Average Invested Capital over the year, adjusted for acquisitions. The denominator of our ROIC calculation.
CAPITAL_INVESTED_ADJUSTED
Adjusted EBIT/EBT
Adjusted operating earnings before interest and taxes. This version of EBIT is adjusted for unusual gains/losses found only in the footnotes or MD&A.
EBIT
Adjusted EBITDA/EBTDA
Adjusted operating earnings before interest, taxes, depreciation and amortization. This version of EBITDA is adjusted for unusual gains/losses found only in the footnotes or MD&A.
EBITDA
Economic Book Value (EBV)*
Economic book value measures the no-growth value of the company based on the current Net Operating Profit After Tax (NOPAT) of the business.
BOOK_VALUE_ECONOMIC
Economic Earnings
Represents the true cash flows available to equity investors.
ECONOMIC_PROFIT
Enterprise Value*
Represents the total value of the company. Enterprise value takes into effect all assets and liabilities that constitute the value of the company. Simply, it is the amount of money needed to purchase the entire company and pay off all debtors and other stakeholders.
ENTERPRISE_VALUE
FCF (Free Cash Flow)
Equals NOPAT less incremental change in working capital less incremental change in fixed assets.
FREE_CASH_FLOW
NOPAT (Net Operating Profit After Tax)
NOPAT (Net Operating Profit After Tax)
NOPAT
NOPBT (Net Operating Profit Before Tax)
NOPBT (Net Operating Profit Before Tax)
NOPBT
ROIC (Return On Invested Capital)
ROIC (Return On Invested Capital)
ROIC

*Indicates the datapoint is affected by stock price.

API: Data Errors

Error
Message
Error Code
DataPointNotFound
The requested datapoint was not found.
404