Industry Economics Worldwide API
About the API
Industry Economics Worldwide is a single subscription that includes access to three types of data: Industrial Utilities Prices & Costs, Plant Location Factors, and Plant Construction Cost Indexes. The documentation pages can be found on the Intratec Developer Portal at:
- Industry Economics Worldwide: https://intrat.ec/iiew-api-portal
The previous three APIs — Industrial Utilities Prices & Costs, Plant Location Factors, and Plant Construction Cost Indexes — have now been replaced by a single, unified API that provides access to all datasets in one place.
Replace your previous endpoints with: https://intratec.azure-api.net/industry_economics — all operations and your existing setup will continue to work seamlessly.
The Intratec Industry Economics Worldwide API provides direct access to the data released under the Industry Economics Worldwide subscription.
These RESTful APIs provide a simple interface for a timely and efficient retrieval of the most current data available.
The results from Industry Economics Worldwide API data queries will return in JavaScript Object Notation (JSON) format, that can be easily plugged into the formatting file or graphic of choice.
API Core Concepts
Data Assessment
Data assessment is a specific monthly time-series comprising prices, costs, indexes, or location factors since Jan/2007. For Industry Economics Worldwide they can be:
- Price or Cost assessments, when referring to prices or costs of a given utility in a location under specific terms.
- Cost indexes assessments, when referring to indexes for adjusting construction costs of industrial plants for a given country.
- Location factor assessments, when referring to location factors for estimating the construction costs of industrial plants in a given country, using the construction cost of industrial plants in another.
A data assessment comprises historical values and forecasts when available.
Cost assessment description example: "Compressed Air, United States, cash cost, formula"
Location Factor Assessment example: "Intratec Plant Location Factor, Finland from United States"
Index Assessment example: "Intratec Plant Construction Cost Index, Finland"
Data Assessment Code
Each data assessment is associated with a unique identifier code, which is used to retrieve the assessment data in the Intratec Industry Economics Worldwide API.
Cost assessment code example: "73470-7-1"
Location Factor Assessment code example: "2259-6-2"
Index Assessment code example: "8318-5-2"
The Intratec team continuously works to add new assessments to Intratec Industry Economics Worldwide. For example, while some new cost assessments may approach the same utility and location, they could feature different negotiation terms, requiring a different code.
Intratec suggests that the data assessment code is used to identify the data assessment at the user end to ensure consistency of data as new data assessments come out.
If a data series basis significantly changes, the data assessment will be discontinued, and another data assessment will be created with a new assessment code.
There can be, however, changes that will not result in the creation of a new assessment, such as specific data points revision or minor value revisions throughout the entire series due to methodology adjustments.
Data Request
A data request is the act of requesting data from a data assessment through the API. It is important to note that a data request is different from an API call.
One API call may include multiple data requests. In a single API call, the user can specify multiple assessment codes to retrieve data from various assessments.
Understanding the difference between a data request and an API call is key, as some API limits are based on the number of data requests rather than the number of API calls.
Available Datasets
Intratec Industry Economics Worldwide are accessible via an annual subscription in which subscribers have access to reliable data to assess and track important drivers of manufacturing competitiveness across 33 countries:
United States, Australia, Belgium, Brazil, Finland, Chile, China, Colombia, Czech Republic, Indonesia, France, Germany, Hungary, India, Norway, Italy, Japan, Mexico, Netherlands, Singapore, Philippines, Poland, Russia, Saudi Arabia, Taiwan, South Africa, South Korea, Spain, Sweden, Thailand, Turkey, United Kingdom, Canada.
The API will only access datasets included in the user's subscription. The list of available data assessments under the user's subscription can be retrieved via Intratec Industry Economics Worldwide API.
Data Releases
New data points are released monthly according to the schedule provided at Intratec Release Schedule.
Intratec recommends scheduling the client application to query values once a month on a predefined date.
For selecting the date that best fits the company's needs, mind the Scheduled Maintenance section.
Getting Started with APIs
This section gives the basic information needed to start working with the Intratec Industry Economics Worldwide API.
The use of Intratec Industry Economics Worldwide API is subject to having a user set with the Developer role. This user will be the only one with access to the API. Learn how to set user with the Developer role.
Intratec strongly recommends that the developer role is assigned to a shared corporate email address, ensuring that (i) the API access can be shared among multiple team members and (ii) API access is not interrupted if a team member leaves the company.
Available APIs
The following public APIs are available for use to authorized accounts:
Access Token API
This API is used to authenticate the calling service. It will also generate an access token needed when calling other Intratec APIs for authorization purposes. The access token is a JSON Web Token (JWT).
This API comprises a single operation:
Intratec Industry Economics Worldwide API
The base URL for the Industry Economics Worldwide API is https://intratec.azure-api.net/industry_economics
It comprises the following operations:
API Flow
Follow the steps below to use the Intratec Industry Economics Worldwide API effectively. The steps cover everything from authentication to making requests. Adhering to this structured approach guarantees optimal performance and reliable access to data.
Need help? Have any issues setting up the API or find any error? Please contact us.
Step 1: Generate an Access Token
Use the Access Token API to authenticate the account credentials and generate the access token needed to use the Intratec Industry Economics Worldwide API.
Intratec APIs access tokens have a limited lifetime of two hours. After this time, the user must obtain a new access token by executing the Access Token API again.
Step 2: List Available Data Assessments
Use the Series Info operation from Intratec Industry Economics Worldwide to list the available data assessments and their respective metadata. Additionally, the list includes the data assessment codes, which are required to query data.
The data assessment metadata comprises, for instance, complete description; currency and unit of measurement in which data is displayed by default; other available currencies and units of measurement for retrieving data; and availability of data forecasts. It also informs whether historical data has been revised.
This operation also provides the date of the most recent update to the assessment data. This information can be used to determine if new data is available and whether new data requests should be made.
Tip 1: Utilize the data assessment code to distinguish data assessments at the user end, ensuring data consistency if new data assessments are created. There's also the option to link this code to an internal description to better suit the company's requirements.
Tip 2: Use this operation to check for changes to existing data assessments or data assessment additions.
Step 3: Query Data Assessment Values
After selecting the data assessment codes, use the corresponding Intratec Industry Economics Worldwide API to query the data assessment values. There are two different operations for that purpose:
Series Values: This operation retrieves data for the most recently concluded month, as well as for the previous 12 months, totaling 13 months of historical data. Additionally, it provides data forecasts for the subsequent 6 months (when provided by Intratec). It is advisable to use this operation after each new data release to ensure access to the latest information, as it is generally faster than Series Values History.
Series Values History: This operation's availability is subject to the Data Automation Option of the API plan. It retrieves monthly historical data up to the most recently concluded month. It also includes forecasts for the subsequent 6 months when available. It should be used when initially setting up data in the client application or when historical data is reviewed by Intratec.
Both operations support up to 40 data assessment codes for any subscription data.
The customization of both currency and unit of measurement for data display is available for Industrial Utilities Prices & Costs.
Tip 3: Use the Series Info operation to check for any revisions to the assessment data. Based on this information, choose between using Series Values or Series Values History to retrieve data from a specific data assessment.
Query Limits
Understanding the query limits of the API is essential to efficiently manage usage and avoid interruptions. This section outlines the daily and monthly quotas for various operations, as well as specific restrictions on data series requests based on the Data Automation Option.
Need help? Have any issues setting up the API or find any error? Please contact us.
Daily Quotas
All operations performed using the API are subject to a daily quota of 8,000 requests.
Monthly Quotas
In addition to the daily quota, some operations have additional monthly limits. The "Series Info" operation is limited to 10,000 requests per month.
The operations Series Values and Series Values History are also restricted based on the number of data requests that can be made per dataset in a month. This limit is based on the selected Data Automation Option.
All monthly quotas are reset when new data are released at the beginning of each month, according to the Intratec Release Schedule. Attempting to request more codes than the plan allows will result in an error.
Monitoring Usage
To help stay within the plan's limits, the user can monitor the usage via the Data Limits operation. This will provide information on the current data series requests usage, as shown in the Examples section. Accessing the Data Limits operation via the Industrial Utilities Prices & Costs, Plant Location Factors, or Plant Construction Cost Indexes endpoints will result in the same usage report, as the three types of subscription data contribute to the Industry Economics Worldwide data limits.
Handling Quota Exceedances
If the user exceeds the monthly quota or requests more data series than allowed by the plan, the user will receive an error response indicating the quota limit has been reached. Here are some best practices to manage and optimize the usage:
- Monitor Usage via Data Limits operation: Regularly check the usage to stay within the limits.
- Data Automation Option: If the usage frequently exceeds the monthly limits, consider upgrading the plan to accommodate higher demand.
By understanding and adhering to these query limits, users can ensure seamless and uninterrupted access to the API services.
Data Query Limit Example
Consider the following scenario:
Total Request Limit:
- 500 data requests for the 'United States' dataset.
- 500 data requests for the 'Germany' dataset.
The user then proceeds to make the following requests:
Industry Economics Worldwide: Series Values Operation:
- 10 cost data requests of the 'United States' dataset.
Industry Economics Worldwide: Series Values Operation:
- 1 index data request of the 'Germany' dataset.
Industry Economics Worldwide: Series Values History Operation:
- 1 location factor data request of the 'Germany' dataset.
After these requests, the user will have 490 remaining data requests in the 'United States' dataset and 498 remaining in the 'Germany' dataset.
Rate limiting also applies to API requests. Users can make up to 10 requests per second per operation.
API Sandbox
The Industry Economics Worldwide API Sandbox environments enable developers to use the API without any monthly restrictions on the number of requested codes.
The API Sandbox comprises different endpoints that will process requests exactly like the actual API providing responses with the exact same format, allowing developers to make tests and configure their applications.
The monthly values returned by the API Sandbox are dummy negative values.
The API Sandbox is subject to the following daily quotas:
- Sandbox – Series Info: 8,000 requests/day
- Sandbox – Series Values: 16,000 requests/day
- Sandbox – Series Values History: 16,000 requests/day
Example API Queries
The examples below are based on the API Sandbox Environments.
To query actual values, simply remove /sandbox from the URL in the example.
This section aims to provide simple usage examples of Intratec Industry Economics Worldwide API. Users can test and use APIs productively in their instances using a REST API client of choice.
For detailed mapping information and Python implementation examples, please refer to the Developer Portal. Links are provided after each example.
Generating Access Token
To generate this token, the user should send a POST request like the following:
Example Request:
POST https://intratec.azure-api.net/access_token/v1 HTTP/1.1
Host: intratec.azure-api.net
Content-Type: application/json
{"password":"password","username":"john.doe@intratec.us"}Example Response:
{
"access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6Nfg"
}For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Listing Available Data Assessments
To send a request to obtain the available data assessments codes and details.
Example Request for the Industry Economics Worldwide subscription data:
GET https://intratec.azure-api.net/industry_economics/v1/sandbox/export/series HTTP/1.1
Host: intratec.azure-api.net
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6NfgExample Response for the Industry Economics Worldwide subscription data:
[{
"area": "N/A",
"assessment": "Compressed Air, United States, cash cost, formula",
"available_currencies": "USD, USD cent, EUR, CNY, JPY, GBP",
"available_units": "Nm3",
"code": "73470-7-1",
"commodity": "Compressed Air",
"coverage": "United States",
"default_currency": "USD cent",
"default_unit": "Nm3",
"details": "N/A",
"has_forecast": true,
"has_preliminary": true,
"last_available_final": "2024-01-01",
"location": "United States",
"product": "Industry Economics Worldwide",
"remark_1": "lag: 2",
"remark_2": "N/A",
"series_hist_changed": false,
"specification": "Dry Compressed Air at 8 bar",
"updated_at": "2024-04-09"
},
...
]For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Need help? Have any issues setting up the API or find any error? Please contact us.
Querying Values for a Single Data Assessment
Example Request for the Industry Economics Worldwide subscription data:
GET https://intratec.azure-api.net/industry_economics/v1/sandbox/export/series/73470-7-1 HTTP/1.1
Host: intratec.azure-api.net
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6Nfg- Before trying the example request, please make sure it includes codes of data assessments available under the subscription.
- Intratec currently does not offer forecast data for Plant Location Factors. For this reason, the item
series_forecast_valuesremains an empty array. - Each subscription data endpoint can only process requests for codes of the same subscription data.
Example Response for the Industry Economics Worldwide subscription data:
[{
"assessment": "Compressed Air, United States, cash cost, formula",
"code": "73470-7-1",
"coverage": "United States",
"currency": "USD cent",
"product": "Industry Economics Worldwide",
"remark_1": "lag: 2",
"remark_2": "N/A",
"series_final_values": [{
"date": "2024-03-01",
"value": -555
},
...
{
"date": "2023-03-01",
"value": -555
}],
"series_forecast_values": [{
"date": "2024-09-01",
"value": -555
},
...
{
"date": "2024-04-01",
"value": -555
}],
"unit": "Nm3",
"updated_at": "2024-04-09"
}]For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Querying Values in Another Currency (Industrial Utilities Prices & Costs only)
Specify a different output currency by adding &c= after the code. The example request queries values in British Pounds (GBP) - =9.
Example Request:
GET https://intratec.azure-api.net/industry_economics/v1/sandbox/export/series/73470-7-1&c=9 HTTP/1.1
Host: intratec.azure-api.net
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6Nfg- Find available currencies and respective in the Currency Reference section.
- If invalid is provided, values will be displayed in the default currency.
- Before trying the example request, please make sure it includes codes of cost assessments available under the subscription.
Example Response:
[{
"assessment": "Compressed Air, United States, cash cost, formula",
"code": "73470-7-1",
"coverage": "United States",
"currency": "GBP",
"product": "Industry Economics Worldwide",
"remark_1": "lag: 2",
"remark_2": "N/A",
"series_final_values": [{
"date": "2024-03-01",
"value": -4.367730576532258
},
...
{
"date": "2023-03-01",
"value": -4.570721443403226
}],
"series_forecast_values": [{
"date": "2024-09-01",
"value": -4.38177497414358
},
...
{
"date": "2024-04-01",
"value": -4.376074306530207
}],
"unit": "Nm3",
"updated_at": "2024-04-09"
}]For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Querying Values in Another Unit of Measurement (Industrial Utilities Prices & Costs only)
Specify a different output unit by adding &u= after the code. The example request queries values in normal cubic meter (Nm3) - =5.
Example Request:
GET https://intratec.azure-api.net/industry_economics/v1/sandbox/export/series/73470-7-1&u=5 HTTP/1.1
Host: intratec.azure-api.net
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6Nfg- Find units of measurement and respective in the Unit Reference section.
- Find available units of measurement for each assessment with Series Info operation.
- If invalid is provided, values will be displayed in the default unit of measurement.
- Before trying the example request, please make sure it includes codes of cost assessments available under the subscription.
Tip: Users can specify both unit and currency for the same code, no matter the order of the parameters.
73470-7-1&u=5&c=9 is equivalent to 73470-7-1&c=9&u=5
Example Response:
[{
"assessment": "Compressed Air, United States, cash cost, formula",
"code": "73470-7-1",
"coverage": "United States",
"currency": "USD cent",
"product": "Industry Economics Worldwide",
"remark_1": "lag: 2",
"remark_2": "N/A",
"series_final_values": [{
"date": "2024-03-01",
"value": -555
},
...
{
"date": "2023-03-01",
"value": -555
}],
"series_forecast_values": [{
"date": "2024-09-01",
"value": -555
},
...
{
"date": "2024-04-01",
"value": -555
}],
"unit": "Nm3",
"updated_at": "2024-04-09"
}]For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Need help? Have any issues setting up the API or find any error? Please contact us.
Querying Values for Multiple Cost Assessments
Example Request for the Industry Economics Worldwide subscription data:
GET https://intratec.azure-api.net/industry_economics/v1/sandbox/export/series/73470-7-1,65140-7-1 HTTP/1.1
Host: intratec.azure-api.net
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6Nfg- Users can request up to 40 codes per data query.
- Codes must be separated by comma.
- Users can make queries of multiple codes with specific currencies and units of measurement. E.g.:
...series/73470-7-1&c=9&u=5,65140-7-1&c=9&u=6 - Before trying the example request, please make sure it includes codes of data assessments available under the subscription.
Example Response for the Industry Economics Worldwide subscription data:
[{
"assessment": "Compressed Air, United States, cash cost, formula",
"code": "73470-7-1",
"coverage": "United States",
"currency": "USD cent",
"product": "Industry Economics Worldwide",
"remark_1": "lag: 2",
"remark_2": "N/A",
"series_final_values": [...],
"series_forecast_values": [...],
"unit": "Nm3",
"updated_at": "2024-04-09"
}, {
"assessment": "Steam, High Pressure, United States, cash cost, formula, on-site (typical consumer facility)",
"code": "65140-7-1",
"coverage": "United States",
"currency": "USD",
"product": "Industry Economics Worldwide",
...
}]For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Querying Data Assessment Historical Values
Example Request for the Industry Economics Worldwide subscription data:
GET https://intratec.azure-api.net/industry_economics/v1/sandbox/export/series_hist/73470-7-1 HTTP/1.1
Host: intratec.azure-api.net
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6NfgBefore trying the example request, please make sure it includes codes of data assessments available under the subscription.
Example Response for the Industry Economics Worldwide subscription data:
[{
"assessment": "Compressed Air, United States, cash cost, formula",
"code": "73470-7-1",
"coverage": "United States",
"currency": "USD cent",
"product": "Industry Economics Worldwide",
"remark_1": "lag: 2",
"remark_2": "N/A",
"series_final_values": [{
"date": "2024-03-01",
"value": -555
},
...
{
"date": "2014-03-01",
"value": -555
}],
"series_forecast_values": [{
"date": "2024-09-01",
"value": -555
},
...
{
"date": "2024-04-01",
"value": -555
}],
"unit": "Nm3",
"updated_at": "2024-04-09"
}]For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Need help? Have any issues setting up the API or find any error? Please contact us.
Verifying Data Request Limits
To check the total and remaining requests for each subscribed dataset of Series Values and Series Values History operations.
Example Request for the Industry Economics Worldwide subscription data:
GET https://intratec.azure-api.net/industry_economics/v1/data_limits HTTP/1.1
Host: intratec.azure-api.net
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI ... SpvL9ZfVEGwch6Nfg- Only countries users are subscribed to appear in the response.
- The remaining requests are reset when new data are released, according to Intratec Data Release Schedule.
Example Response:
{
"United States": {
"remaining_requests": 594,
"total_requests": 600
},
"Germany": {
"remaining_requests": 598,
"total_requests": 600
},
"Finland": {
"remaining_requests": 594,
"total_requests": 600
},
"China": {
"remaining_requests": 523,
"total_requests": 600
},
...
}For detailed data mapping, as well as python and VBA implementation examples, please refer to the developer portal.
Need help? Have any issues setting up the API or find any error? Please contact us.
Scheduled Maintenance
Intratec Industry Economics Worldwide API goes unavailable during regular maintenance procedures from 6 am to 10 pm (US Central Time) on the following days:
- 15th day of the month
- 25th day of the month
On the day when monthly data is released, the APIs become unavailable at 6 am and become available again once the new data is released. The deadline for releasing the new data is 10 pm (US Central Time). Users can find the release date in the Intratec Data Release Schedule.
API Versioning
Versioning of Intratec Industry Economics Worldwide API follows widely accepted concepts to differentiate between breaking and non-breaking changes. In case of breaking changes, the recent APIs versions are still available but marked as deprecated. Deprecated APIs and API versions will be supported for at least 3 months from the date of deprecation. However, we highly recommend that users migrate to the most recent APIs as soon as possible.
Any modifications, improvements and corrections to the APIs will be documented and published on the Release Notes page.
The following are examples of breaking (incompatible) and non-breaking (also known as "compatible" or "smooth") changes in REST APIs.
Examples of breaking changes:
- Deleting an operation
- Deleting or renaming parameters
- Changing the type of a parameter
Examples of non-breaking changes:
- Adding an operation
- Adding a non-mandatory parameter
- Adding non-mandatory properties to a resource
As APIs do not remain fixed and unchanged within the same API version, API consumers must prepare their client-side implementation to handle non-breaking changes.