API: Traditional Value Screens

This data set contains scrubbed accounting data - a better version of the components used in your traditional value screens. Updated daily.

API: Traditional Value Screens: Single Datapoint

Endpoint
URL
Method
/screens/traditional/: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
REVENUE
: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.
REVENUE
datavalue
Value of the requested datapoint in ones.
233715000000.00000000000000000
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/traditional/AAPL?datapoint=REVENUE&year=2015'
Success Response: 

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

API: Traditional Value Screens: All Datapoints

Endpoint
URL
Method
/screens/traditional/: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.
REVENUE
datavalue
Value of the datapoint in ones.
233715000000.00000000000000000
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": "REVENUE",
        "datavalue": "233715000000.00000000000000000",
      "filingtype": "10-K"
      },
      {
        "ticker": "AAPL",
        "year": 2015,
        "period": 5,
        "periodtype": "ANNUAL",
        "periodstring": "ANNUAL",
        "datapoint": "INCOME_NET",
        "datavalue": "53394000000.00000000000000000",
      "filingtype": "10-K"
      },
      ...
    ]
  }
}

Datapoints

Name
Description
Datapoint
Total Revenue
Total revenue as reported on the income statement.
REVENUE
Total Cost of Sales
Total cost of sales, an expense on the income statement.
SALES_COST
Gross Profit
Gross Profit
PROFIT_GROSS
Depreciation and Amortization
Depreciation and amortization, an expense on the income statement.
EXPENSES_DEPRECIATION_AND_AMORTIZATION
Selling, General, and Administrative Expense
Selling, general, and administrative, an expense on the income statement.
EXPENSES_SGA
Research and Development Expense
Research and development expense, an expense on the income statement.
RESEARCH_AND_DEVELOPMENT_EXPENSE
Non-Recurring Expense/(Income)
Total non-recurring expenses disclosed on the income statement.
EXPENSES_NON_RECURRING
GAAP Net Income
GAAP net income.
INCOME_NET
Diluted GAAP EPS (Not Split-Adjusted)
Diluted earnings per share (not split-adjusted).
INCOME_NET_PER_WADSO
Diluted GAAP EPS
Diluted earnings per share.
INCOME_NET_PER_WADSO_SPLIT_ADJUSTED
Cash and Equivalents (Non-Operating)
Cash and cash equivalents, a current asset on the balance sheet. This data point collects cash for non-financial companies.
ASSETS_CURRENT_CASH
Total Current/Investment Assets (Unadjusted)
Total Current/Investment Assets (unadjusted) as reported on the balance sheet.
ASSETS_CURRENT_UNADJUSTED
Total Fixed Assets
Total fixed assets from the balance sheet.
ASSETS_FIXED
Goodwill, net
Goodwill, net, a long-term asset reported on the balance sheet.
GOODWILL_NET
Other Intangibles
Goodwill and intangible assets, net, a long-term asset reported on the balance sheet.
GOODWILL_AND_INTANGIBLES_NET_OTHER
Total Assets (Unadjusted)
Reported total assets as shown in the filing.
ASSETS_UNADJUSTED
Total Current/Investment Liabilities
Total current/investment liabilities.
LIABILITIES_CURRENT
Total Non-Current Liabilities
Total Non-Current Liabilities.
LIABILITIES_NON_CURRENT
Short-Term Debt and Long-Term Debt
Total short-term and long-term non-operating debt.
DEBT
Retained Earnings
Retained earnings, from the shareholders' equity section of the balance sheet.
EARNINGS_RETAINED
Accumulated OCI (Other Comprehensive Income)
Accumulated Other Comprehensive Income, from the shareholders' equity section of the balance sheet.
OCI
Minority Interests
Minority interests, a component of shareholder's equity representing a significant but non-controlling ownership of a company's voting shares by either an investor or another company.
INTEREST_MINORITY
Preferred Capital
Total preferred stock from the Shareholder's Equity section of the balance sheet and the Mezzanine section of the balance sheet.
STOCK_PREFERRED
Total Shareholders' Equity
Total shareholders' equity, from the shareholders' equity section of the balance sheet.
EQUITY_SHAREHOLDER

*Indicates the datapoint is affected by stock price.

API: Data Errors

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