General

What products are available via API?

All IBISWorld’s Industry and Procurement products are available via an API. Access to a product is contingent on your business having
access to that product with an IBISWorld subscription.


What countries are available via API?

All IBISWorld’s Industry and Procurement products are available via an API for all countries – Australia, United States, Canada, China,
United Kingdom and New Zealand. Access to a product is contingent on your business having access to that product with an IBISWorld
subscription.


What are the legal terms and conditions of the IBISWorld API?

The IBISWorld API is governed by our API Terms and Conditions.


Getting Started

Do I need to be an IBISWorld client to access the API?

Yes. The API is only available to clients. To learn more about becoming a client, please contact us.


I’m already a client. What do I need to do?

Further information about the authentication process can be found here.


What coding language do your APIs use?

IBISWorld’s APIs use JSON or XML coding language for ease of incorporation into your systems.


What authentication do you use?

We use OAuth 2.0 authentication for our APIs.

What is an API key?

The AppID, also referred to as an Application ID or an API key, is a string that uniquely identifies your application to IBISWorld.
The AppID must be sent with each IBISWorld API request.


Using the API

What kind of data can I get from the API?

IBISWorld has a full report API which returns the entire Industry or Procurement report. We also have a granular API, which
allows a user to call only individual parts of a report.


How big (i.e. total MB or GB) is the initial download of all API report content?

This depends on the collections you access, although overall collection sizes are small. Typically, all combined Industry reports
will be around 1.5GB; while all Risk reports will be 0.4GB.


How big (i.e. KB, MB) is a single industry report? (This would be via the full report API)

An Industry report is up to 700KB when returned from the API.


How long does it take to download a single industry report?

It takes about 4 seconds to download a full industry report. Download times may vary depending on network speed.


Are there any data limits?

Currently there are no limits, however, we track traffic associated with an individual API key.


Can I cache results from the IBISWorld API?

Yes, you can cache the results, but reports are being updated all the time so we recommend that the cache be refreshed frequently.


On average, how many reports are published daily?

The number of reports published per day varies significantly, ranging from 5 to 15 reports depending on the country, collection and month.
You can use the “UpdatedReports” API to get the list of all reports that have been updated within given date ranges.


Do you have an XML Schema definition in all versions?

Currently, only version 2 of IBISWorld’s API contains an XML Schema.


API Versioning

When do you create new API versions?

We create new API versions when we make a change that will “break” the existing API version. This tends to occur when IBISWorld creates
new or amends content for existing products. The existing API version is amended to continue functioning, but not provide the new content.
E.g. Adding new data is not a breaking change. Changing the reports IDs will be a breaking change (in excel, this would be compared to
renaming columns or rows – thus changing the way to identify data).


When you release new API versions, do you still support previous versions?

Yes, we will continue to support clients on older API versions. However, clients will miss out on any new content or features provided by
the new API version.


Can I test a new API version?

We can provide with a testing login, so it doesn’t impact your usage.