# IBISWorld

> Industry research from IBISWorld: find industry reports by name or NAICS code, and read market size, forecasts, major companies, risk ratings and economic indicators.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/ibisworld

## Actions

### Download report file

Save a report as IBISWorld's own PDF, Word or PowerPoint file, for a later step to email or upload.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Report (`code`, text, required): The report's IBISWorld code. Pick an industry, or give any report's code from a list step or an earlier step.
- Kind of report (`product`, text): What the code is for. Defaults to an industry report. One of: `industry` (Industry report), `risk` (Risk report), `bed` (Business environment profile), `industrystate` (State or provincial industry report), `iexpert` (iExpert summary), `economicprofile` (Economic profile), `company` (Company report), `procurement` (Procurement report). Default: `industry`.
- File type (`file_format`, text): Defaults to PDF. Procurement reports come only as PDF. One of: `pdf`, `word` (Word (.docx)), `powerpoint` (PowerPoint (.pptx)). Default: `pdf`.
- Language (`language`, text): The report's language. Leave empty for IBISWorld's default. One of: `English`, `German`, `French`.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `content_type` (text): The file's media type
- `country` (text): The IBISWorld country code, such as US
- `document_ref` (text): Reference to the saved file, for a later step
- `documents` (list): The saved file, in the shape steps that send or upload files take
- `file_format` (text): pdf, word or powerpoint
- `filename` (text): The name the file was saved under
- `product` (text): The kind of report, such as industry
- `size_bytes` (number): The file's size in bytes
- `url` (text): Where Lodol serves the saved file

**Example output**

```json
{
  "code": "A0145",
  "content_type": "application/pdf",
  "country": "AU",
  "document_ref": "doc_c9f0f895fb98ab9159f51fd0297e236d",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_c9f0f895fb98ab9159f51fd0297e236d",
      "filename": "ibisworld-industry-au-A0145.pdf",
      "size_bytes": 312480,
      "url": "/actions/core/serve-document/doc_c9f0f895fb98ab9159f51fd0297e236d?teamId=64b7f0c2a1b2c3d4e5f60718"
    }
  ],
  "file_format": "pdf",
  "filename": "ibisworld-industry-au-A0145.pdf",
  "product": "industry",
  "size_bytes": 312480,
  "url": "/actions/core/serve-document/doc_c9f0f895fb98ab9159f51fd0297e236d?teamId=64b7f0c2a1b2c3d4e5f60718"
}
```

### Find industry reports by classification code

Find the IBISWorld reports that cover official industry codes, such as NAICS, ANZSIC, UK SIC, NACE or ISIC codes.

**Inputs**

- Country (`country`, text, required): The country whose classification systems to use, such as United States for NAICS. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Classification codes (`classification_codes`, list, required): The official codes, such as the NAICS code 11111. Up to 50.
- Classification system (`classification_system`, text): The system the codes are in, such as NAICS 2022. Leave empty to use every system IBISWorld maps for the country.
- Collections (`collections`, list): Only reports in these collections. Leave empty for every collection. One or more of: `COR` (Core reports), `SPE` (Specialized reports), `SPO` (Spotlight reports), `Core-ISIC` (Core reports on ISIC codes), `Proc` (Procurement reports).

**Outputs**

- `count` (number): How many matches came back
- `matches` (list): One row for each report that covers a code
- `summary` (text): One sentence saying what came back
- `unmatched_codes` (list): Codes no IBISWorld report covers

**Example output**

```json
{
  "count": 1,
  "matches": [
    {
      "classification_code": "11111",
      "classification_system": "NAICS 2022 - USA",
      "classification_title": "Soybean Farming",
      "published_date": "2025-04-17T00:00:00",
      "report_code": "11111",
      "report_collection": "Core",
      "report_country": "US",
      "report_title": "Soybean Farming in the US",
      "tier": 4
    }
  ],
  "summary": "1 reports cover 1 of 1 codes.",
  "unmatched_codes": []
}
```

### Get an industry's classification codes

Get the official codes (NAICS, ANZSIC, UK SIC, NACE, ISIC) that IBISWorld reports map to.

**Inputs**

- Country (`country`, text, required): The country whose classification systems to use, such as United States for NAICS. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industries (`report_codes`, list, required): IBISWorld report codes, such as 11111, from 'List industry reports' or an earlier step. Up to 50.
- Classification system (`classification_system`, text): The system the codes are in, such as NAICS 2022. Leave empty to use every system IBISWorld maps for the country.

**Outputs**

- `codes` (list): One row for each classification code a report maps to
- `count` (number): How many rows came back
- `summary` (text): One sentence saying what came back
- `unmatched_reports` (list): Report codes IBISWorld mapped to nothing

**Example output**

```json
{
  "codes": [
    {
      "classification_code": "11111",
      "classification_system": "NAICS 2022 - USA",
      "classification_title": "Soybean Farming",
      "classification_version": "NAICS-2022-USA",
      "is_primary": true,
      "published_date": "2025-04-17T00:00:00",
      "report_code": "11111",
      "report_collection": "Core",
      "report_country": "US",
      "report_title": "Soybean Farming in the US",
      "sector_code": "11",
      "tier": 4
    }
  ],
  "count": 1,
  "summary": "1 classification codes for 1 of 1 reports.",
  "unmatched_reports": []
}
```

### Get business environment profile

Get an economic indicator's definition, performance and outlook, its values each year with forecasts, and the industries it affects.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany).
- Profile (`code`, text, required): The indicator. Pick one, or give its code from 'List business environment profiles' or an earlier step.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `country` (text): The IBISWorld country code, such as US
- `current_performance` (text): How it moved over the last five years
- `data` (list): One value per year, forecasts included
- `definition` (text): What the indicator measures
- `industries_affected` (list): Industries the indicator affects
- `is_absolute_change` (true/false): Whether change is an amount rather than a %
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `monthly_data` (list): Monthly values, for producer price indexes only
- `outlook` (text): How it is expected to move over the next five years
- `published_date` (text): When IBISWorld last published the report (UTC, ISO 8601)
- `summary` (text): One sentence saying what came back
- `title` (text): The indicator, such as Album sales
- `unit` (text): The unit of its values, such as Million

**Example output**

```json
{
  "code": "F314",
  "country": "US",
  "current_performance": "Album sales reached 204.0 million units in 2025, representing a continued decline in the traditional album market.",
  "data": [
    {
      "change": -3.1,
      "value": 212.5,
      "year": 2024
    },
    {
      "change": -4.0,
      "value": 204.0,
      "year": 2025
    }
  ],
  "definition": "US album sales represent the total number of physical and digital albums sold annually in the United States, measured in millions of units.",
  "industries_affected": [
    {
      "code": "45122",
      "definition": "Record stores primarily retail prerecorded audio and videotapes, CDs, DVDs, Blu-ray discs and phonograph records.",
      "title": "Record Stores in the US"
    }
  ],
  "is_absolute_change": false,
  "missing_sections": [
    "monthlydataseries"
  ],
  "monthly_data": [],
  "outlook": "Album sales are projected to decline to 188.5 million units in 2026.",
  "published_date": "2025-08-26T07:22:17",
  "summary": "Album sales: 204.0 Million in 2025.",
  "title": "Album sales",
  "unit": "Million"
}
```

### Get ESG report

Get an industry's environmental, social and governance risk assessment (Australia, UK and Germany): scores, trends, climate and regulation.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `AU` (Australia), `UK` (United Kingdom), `DE` (Germany).
- Industry (`code`, text, required): The industry. Pick one, or give its IBISWorld code from 'List industry reports' or an earlier step.
- Sections (`sections`, list): The sections to get. Leave empty for every section. One or more of: `title`, `esgscore` (ESG score), `esgcomponentscores` (ESG component scores), `environmentalscore` (Environmental score), `socialscore` (Social score), `governancescore` (Governance score), `climate`, `environmentalstatisticaltrends` (Environmental statistical trends), `socialstatisticaltrends` (Social statistical trends), `statisticaltrends` (Statistical trends), and 3 more.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `content` (object): Every section's data in one object, keyed as IBISWorld names it (KeyStatistics, Definition, SWOT and so on)
- `country` (text): The IBISWorld country code, such as US
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `sections` (list): Each section asked for, in order
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, when the Title section was asked for

**Example output**

```json
{
  "code": "C1211",
  "content": {
    "Title": "Beer Manufacturing in Australia"
  },
  "country": "AU",
  "missing_sections": [
    "climate"
  ],
  "sections": [
    {
      "content": {
        "Title": "Beer Manufacturing in Australia"
      },
      "found": true,
      "name": "title",
      "status_code": 200
    },
    {
      "content": {},
      "found": false,
      "name": "climate",
      "status_code": 404
    }
  ],
  "summary": "1 of 2 sections of Beer Manufacturing in Australia (AU). Not available: climate.",
  "title": "Beer Manufacturing in Australia"
}
```

### Get industry chart

Save one of an industry report's charts, such as revenue or market share, as a PNG image a later step can send or upload.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industry (`code`, text, required): The industry. Pick one, or give its IBISWorld code from 'List industry reports' or an earlier step.
- Chart (`chart`, text, required): The chart to save. One of: `revenue`, `employees`, `businesses`, `establishments`, `profitmargin` (Profit margin), `lifecycle` (Life cycle), `productsandservices` (Products and services), `majormarkets` (Major markets), `internationaltradeimports` (Imports by country), `internationaltradeexports` (Exports by country), and 4 more.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `chart` (text): The chart asked for, such as revenue
- `chart_name` (text): IBISWorld's name for the chart, such as Revenue
- `code` (text): The IBISWorld report code, unique within its country
- `content_type` (text): The file's media type
- `country` (text): The IBISWorld country code, such as US
- `document_ref` (text): Reference to the saved file, for a later step
- `documents` (list): The saved file, in the shape steps that send or upload files take
- `filename` (text): The name the file was saved under
- `size_bytes` (number): The file's size in bytes
- `url` (text): Where Lodol serves the saved file

**Example output**

```json
{
  "chart": "revenue",
  "chart_name": "Revenue",
  "code": "11111",
  "content_type": "image/png",
  "country": "US",
  "document_ref": "doc_8f14e45fceea167a5a36dedd4bea2543",
  "documents": [
    {
      "content_type": "image/png",
      "document_ref": "doc_8f14e45fceea167a5a36dedd4bea2543",
      "filename": "ibisworld-us-11111-revenue.png",
      "size_bytes": 48211,
      "url": "/actions/core/serve-document/doc_8f14e45fceea167a5a36dedd4bea2543?teamId=64b7f0c2a1b2c3d4e5f60718"
    }
  ],
  "filename": "ibisworld-us-11111-revenue.png",
  "size_bytes": 48211,
  "url": "/actions/core/serve-document/doc_8f14e45fceea167a5a36dedd4bea2543?teamId=64b7f0c2a1b2c3d4e5f60718"
}
```

### Get industry key statistics

Get an industry's market size and forecast: revenue, value added, businesses, employment, wages, exports and imports for every year.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industry (`code`, text, required): The industry. Pick one, or give its IBISWorld code from 'List industry reports' or an earlier step.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `annual_change` (list): How much each statistic changed year on year
- `by_year` (list): One row per year with each key statistic, in its own unit (see statistics)
- `code` (text): The IBISWorld report code, unique within its country
- `country` (text): The IBISWorld country code, such as US
- `current_year` (number): The report's year: later years are forecasts
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `published_date` (text): When IBISWorld last published the report (UTC, ISO 8601)
- `ratios` (list): Each key ratio, such as revenue per employee, for every year
- `statistics` (list): Each key statistic with its value for every year
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, such as Soybean Farming in the US

**Example output**

```json
{
  "annual_change": [
    {
      "name": "Revenue",
      "unit": "%",
      "values": [
        {
          "change": -6.6,
          "end_year": 2025,
          "inflation_adjusted_change": -8.7,
          "start_year": 2024
        }
      ]
    }
  ],
  "by_year": [
    {
      "employment": 197016,
      "enterprises": 97185,
      "establishments": 97207,
      "exports": 24568.3,
      "imports": 379.6,
      "is_forecast": false,
      "iva": 14481.4,
      "revenue": 47354.4,
      "wages": 818.1,
      "year": 2024
    },
    {
      "employment": 185214,
      "enterprises": 93700,
      "establishments": 93721,
      "exports": 22547.6,
      "imports": 368,
      "is_forecast": false,
      "iva": 12899.9,
      "revenue": 44244.4,
      "wages": 782.7,
      "year": 2025
    },
    {
      "employment": 209196,
      "enterprises": 103080,
      "establishments": 103201,
      "exports": 27046.8,
      "imports": 401.4,
      "is_forecast": true,
      "iva": 21134.8,
      "revenue": 51467.6,
      "wages": 889.4,
      "year": 2031
    }
  ],
  "code": "11111",
  "country": "US",
  "current_year": 2025,
  "missing_sections": [],
  "published_date": "2025-04-16T17:08:11",
  "ratios": [
    {
      "multiplier": 1,
      "name": "Revenue per Employee",
      "unit": "$",
      "values": [
        {
          "inflation_adjusted_value": 238882,
          "value": 238882,
          "year": 2025
        }
      ]
    }
  ],
  "statistics": [
    {
      "multiplier": 1000000,
      "name": "Revenue",
      "unit": "$ million",
      "values": [
        {
          "inflation_adjusted_value": 48474.2,
          "value": 47354.4,
          "year": 2024
        },
        {
          "inflation_adjusted_value": 44244.4,
          "value": 44244.4,
          "year": 2025
        },
        {
          "inflation_adjusted_value": 51467.6,
          "value": 51467.6,
          "year": 2031
        }
      ]
    },
    {
      "multiplier": 1,
      "name": "Employment",
      "unit": "Units",
      "values": [
        {
          "inflation_adjusted_value": 197016,
          "value": 197016,
          "year": 2024
        },
        {
          "inflation_adjusted_value": 185214,
          "value": 185214,
          "year": 2025
        },
        {
          "inflation_adjusted_value": 209196,
          "value": 209196,
          "year": 2031
        }
      ]
    }
  ],
  "summary": "Soybean Farming in the US: revenue $44,244.4 million in 2025, forecast $51,467.6 million in 2031.",
  "title": "Soybean Farming in the US"
}
```

### Get industry overview

Get an industry's definition, executive summary, key takeaways, headline figures, structure and SWOT as plain text.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industry (`code`, text, required): The industry. Pick one, or give its IBISWorld code from 'List industry reports' or an earlier step.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `caption` (text): IBISWorld's one sentence on where the industry stands
- `code` (text): The IBISWorld report code, unique within its country
- `country` (text): The IBISWorld country code, such as US
- `definition` (text): What the industry covers and leaves out
- `executive_summary` (text): A 300 to 400 word briefing on the last and next five years
- `highlights` (list): Headline figures, such as revenue, profit margin and employment
- `key_takeaways` (list): The analyst's key takeaways
- `main_activities` (list): The industry's main products and services
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `published_date` (text): When IBISWorld last published the report (UTC, ISO 8601)
- `structure` (list): How the industry is built: competition, concentration, barriers to entry and more
- `summary` (text): One sentence saying what came back
- `swot` (object): Strengths, weaknesses, opportunities and threats
- `title` (text): The report's title, such as Soybean Farming in the US

**Example output**

```json
{
  "caption": "Soybean prices set the pace as biofuel demand lifts soybean oil.",
  "code": "11111",
  "country": "US",
  "definition": "Farms in this industry grow soybeans as their main crop. Soybeans are most often used in livestock feeds and vegetable oils.",
  "executive_summary": "The US soybean farming industry is navigating significant changes in the current period, with soybean prices determining the initial rise and recent decline in industry performance.",
  "highlights": [
    {
      "forecast_growth": 1.3,
      "historical_growth": -4.8,
      "name": "IVA / Revenue",
      "unit": "%",
      "value": 29.2,
      "year": 2025
    }
  ],
  "key_takeaways": [
    {
      "chapter": "Performance",
      "takeaway": "Global soybean prices determine soybean farming revenue. Soybean prices surged in 2021 and 2022 but are now quickly falling back down."
    }
  ],
  "main_activities": [
    "Soybean oil",
    "Soybean meal",
    "Soybean hulls"
  ],
  "missing_sections": [],
  "published_date": "2025-04-16T17:08:11",
  "structure": [
    {
      "characteristic": "Barriers to Entry",
      "level": "High",
      "trend": "Steady"
    },
    {
      "characteristic": "Capital Intensity",
      "level": "High",
      "trend": ""
    }
  ],
  "summary": "Soybean prices set the pace as biofuel demand lifts soybean oil.",
  "swot": {
    "opportunities": [
      "High Revenue Growth (2025-2030)"
    ],
    "strengths": [
      "High & Steady Barriers to Entry",
      "Low Imports"
    ],
    "threats": [
      "Low Revenue Growth (2005-2025)"
    ],
    "weaknesses": [
      "High Volatility"
    ]
  },
  "title": "Soybean Farming in the US"
}
```

### Get industry report sections

Get any sections of an industry report, such as the outlook, cost structure, financial ratios or related industries, as IBISWorld gives them.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industry (`code`, text, required): The industry. Pick one, or give its IBISWorld code from 'List industry reports' or an earlier step.
- Sections (`sections`, list, required): The sections to get. One or more of: `title`, `definition`, `author`, `mainactivities` (Main activities), `publicationdate` (Publication date), `pdfchangedate` (PDF change date), `relatedindustries` (Related industries), `relatedinternationalindustries` (Related international industries), `caption`, `executivesummaryanalysis` (Executive summary), and 46 more.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.
- Every year (`all_years`, true/false): Get every year IBISWorld has for cost structure, valuation multiples and local government areas, not just the latest.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `content` (object): Every section's data in one object, keyed as IBISWorld names it (KeyStatistics, Definition, SWOT and so on)
- `country` (text): The IBISWorld country code, such as US
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `sections` (list): Each section asked for, in order
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, when the Title section was asked for

**Example output**

```json
{
  "code": "11111",
  "content": {
    "CostStructure": [
      {
        "Cost": "Wages",
        "Years": [
          {
            "AnnualChange": 0.1,
            "Percentage": 1.8,
            "SubCosts": [
              {
                "Cost": "Other",
                "Percentage": 100
              }
            ],
            "Year": 2025
          }
        ]
      }
    ],
    "Title": "Soybean Farming in the US"
  },
  "country": "US",
  "missing_sections": [],
  "sections": [
    {
      "content": {
        "Title": "Soybean Farming in the US"
      },
      "found": true,
      "name": "title",
      "status_code": 200
    },
    {
      "content": {
        "CostStructure": [
          {
            "Cost": "Wages",
            "Years": [
              {
                "AnnualChange": 0.1,
                "Percentage": 1.8,
                "SubCosts": [
                  {
                    "Cost": "Other",
                    "Percentage": 100
                  }
                ],
                "Year": 2025
              }
            ]
          }
        ]
      },
      "found": true,
      "name": "coststructure",
      "status_code": 200
    }
  ],
  "summary": "2 of 2 sections of Soybean Farming in the US (US).",
  "title": "Soybean Farming in the US"
}
```

### Get industry risk rating

Get an industry's overall, structural, sensitivity and growth risk scores (1 lowest, 9 highest) and how they changed each year.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany).
- Industry (`code`, text, required): The industry's risk report. Pick one, or give its IBISWorld code from 'List risk reports' or an earlier step.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `components` (list): The scores as IBISWorld lists them
- `country` (text): The IBISWorld country code, such as US
- `forecast_year` (number): The year the risk scores look ahead to
- `growth_level` (text): Growth risk in words
- `growth_score` (number): Growth risk, from 1 to 9
- `history` (list): The scores each year
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `overall_level` (text): Overall risk in words, such as Medium - High
- `overall_score` (number): Overall risk, from 1 (lowest) to 9 (highest)
- `published_date` (text): When IBISWorld last published the report (UTC, ISO 8601)
- `sensitivity_level` (text): Sensitivity risk in words
- `sensitivity_score` (number): Sensitivity risk, from 1 to 9
- `structural_level` (text): Structural risk in words
- `structural_score` (number): Structural risk, from 1 to 9
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, such as Soybean Farming in the US

**Example output**

```json
{
  "code": "11111",
  "components": [
    {
      "component": "Structural risk",
      "level": "Medium - Low",
      "score": 4.34,
      "weight": 49.93
    },
    {
      "component": "Sensitivity risk",
      "level": "High",
      "score": 6.36,
      "weight": 50
    },
    {
      "component": "Growth risk",
      "level": "Low",
      "score": 3,
      "weight": 0.07
    },
    {
      "component": "Overall risk",
      "level": "Medium - High",
      "score": 5.35,
      "weight": null
    }
  ],
  "country": "US",
  "forecast_year": 2026,
  "growth_level": "Low",
  "growth_score": 3,
  "history": [
    {
      "economy_score": 4.85,
      "growth_score": 6.95,
      "overall_score": 6.1,
      "sector_score": 5.64,
      "sensitivity_score": 5.49,
      "structural_score": 6.46,
      "year": 2017
    },
    {
      "economy_score": 4.75,
      "growth_score": 6.36,
      "overall_score": 5.91,
      "sector_score": 5.51,
      "sensitivity_score": 5.47,
      "structural_score": 6.32,
      "year": 2018
    }
  ],
  "missing_sections": [],
  "overall_level": "Medium - High",
  "overall_score": 5.35,
  "published_date": "2025-09-08T00:00:00",
  "sensitivity_level": "High",
  "sensitivity_score": 6.36,
  "structural_level": "Medium - Low",
  "structural_score": 4.34,
  "summary": "Soybean Farming in the US: overall risk 5.35 of 9 (Medium - High).",
  "title": "Soybean Farming in the US"
}
```

### Get industry supply chain

Get the industries that buy from an industry and those that supply it, each with its IBISWorld code.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industry (`code`, text, required): The industry. Pick one, or give its IBISWorld code from 'List industry reports' or an earlier step.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `buyers` (list): Industries that buy from this one
- `code` (text): The IBISWorld report code, unique within its country
- `country` (text): The IBISWorld country code, such as US
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `summary` (text): One sentence saying what came back
- `suppliers` (list): Industries that supply this one
- `title` (text): The report's title, such as Soybean Farming in the US

**Example output**

```json
{
  "buyers": [
    {
      "code": "31111",
      "collection": "COR",
      "country": "US",
      "published_date": "2025-05-04T14:15:14",
      "short_title": "Animal Food Production",
      "tier": 1,
      "title": "Animal Food Production in the US"
    },
    {
      "code": "31122",
      "collection": "COR",
      "country": "US",
      "published_date": "2025-05-24T22:54:42",
      "short_title": "Margarine & Cooking Oil Processing",
      "tier": 2,
      "title": "Margarine & Cooking Oil Processing in the US"
    }
  ],
  "code": "11111",
  "country": "US",
  "missing_sections": [],
  "summary": "Soybean Farming in the US: 2 buying and 1 supplying industries.",
  "suppliers": [
    {
      "code": "42382",
      "collection": "COR",
      "country": "US",
      "published_date": "2025-09-15T13:47:26",
      "short_title": "Farm, Lawn & Garden Equipment Wholesaling",
      "tier": 1,
      "title": "Farm, Lawn & Garden Equipment Wholesaling in the US"
    }
  ],
  "title": "Soybean Farming in the US"
}
```

### Get major companies in an industry

Get the largest companies in an industry with their market share, revenue, size and head office.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industry (`code`, text, required): The industry. Pick one, or give its IBISWorld code from 'List industry reports' or an earlier step.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `companies` (list): The major companies, largest first
- `count` (number): How many companies came back
- `country` (text): The IBISWorld country code, such as US
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `other_companies_share` (number): The market share of every other company together, in %
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, such as Soybean Farming in the US

**Example output**

```json
{
  "code": "51913",
  "companies": [
    {
      "company_id": 347859,
      "country": "United States",
      "employee_range": "10,000+",
      "headquarters": "Mountain View, California, United States",
      "market_share": 7.65,
      "market_share_max": null,
      "market_share_min": null,
      "market_share_source": "Analyst Verified",
      "name": "Alphabet Inc.",
      "rank": 1,
      "revenue": 190340.6,
      "revenue_unit": "$m"
    }
  ],
  "count": 1,
  "country": "US",
  "missing_sections": [],
  "other_companies_share": 92.35,
  "summary": "1 major companies in Search Engines in the US.",
  "title": "Search Engines in the US"
}
```

### Get one section for several industries

Get the same section, such as key takeaways or cost structure, from several industry reports at once to compare them.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Industries (`codes`, list, required): IBISWorld report codes, such as 11111, from 'List industry reports' or an earlier step. Up to 50.
- Section (`section`, text, required): The section to get from each report. One of: `title`, `definition`, `author`, `mainactivities` (Main activities), `publicationdate` (Publication date), `pdfchangedate` (PDF change date), `relatedindustries` (Related industries), `relatedinternationalindustries` (Related international industries), `caption`, `executivesummaryanalysis` (Executive summary), and 46 more.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `count` (number): How many reports came back
- `country` (text): The IBISWorld country code, such as US
- `missing_codes` (list): Codes IBISWorld had no section for
- `reports` (list): Each report's copy of the section
- `section` (text): The section that was read
- `summary` (text): One sentence saying what came back

**Example output**

```json
{
  "count": 2,
  "country": "EUR",
  "missing_codes": [],
  "reports": [
    {
      "code": "EU-A011",
      "content": {
        "Title": "Non-Perennial Crop Growing in Europe"
      },
      "found": true,
      "status_code": null
    },
    {
      "code": "EU-F41",
      "content": {
        "Title": "Building Construction in Europe"
      },
      "found": true,
      "status_code": null
    }
  ],
  "section": "title",
  "summary": "The title section of 2 of 2 reports."
}
```

### Get risk early warning

Get where an industry's risk score is heading: the current and previous score, its direction, volatility and recent peak.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany).
- Industry (`code`, text, required): The industry's risk report. Pick one, or give its IBISWorld code from 'List risk reports' or an earlier step.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `category` (text): The risk category, such as Medium
- `code` (text): The IBISWorld report code, unique within its country
- `country` (text): The IBISWorld country code, such as US
- `direction` (text): Where risk is heading, such as Steady
- `forecast_month` (number): The month the forecast reaches
- `forecast_year` (number): The year the forecast reaches
- `growth_score` (number): Growth risk, from 1 to 9
- `intensity` (number): How strongly the risk is moving
- `matrix_score` (number): IBISWorld's risk matrix position
- `overall_score` (number): Overall risk, from 1 (lowest) to 9 (highest)
- `past_peak_score` (number): The highest overall risk in recent years
- `past_peak_year` (number): The year of that peak
- `previous_overall_score` (number): The overall risk before this one
- `previous_score_month` (number): The month of the previous score
- `previous_score_year` (number): The year of the previous score
- `published_month` (number): The month the report was published
- `published_quarter` (number): The quarter the report was published
- `published_year` (number): The year the report was published
- `risk_month` (number): The month of the current score
- `risk_year` (number): The year of the current score
- `score_change` (number): Overall risk now less the previous score
- `sensitivity_score` (number): Sensitivity risk, from 1 to 9
- `structural_score` (number): Structural risk, from 1 to 9
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, such as Soybean Farming in the US
- `volatility` (text): How volatile the industry is, such as High
- `z_score` (number): How far the score sits from the average, in standard deviations

**Example output**

```json
{
  "category": "Medium",
  "code": "11111",
  "country": "US",
  "direction": "Steady",
  "forecast_month": 9,
  "forecast_year": 2026,
  "growth_score": 3,
  "intensity": 0.78,
  "matrix_score": 8,
  "overall_score": 5.35,
  "past_peak_score": 6.9,
  "past_peak_year": 2025,
  "previous_overall_score": 5.35,
  "previous_score_month": 8,
  "previous_score_year": 2025,
  "published_month": 9,
  "published_quarter": 3,
  "published_year": 2025,
  "risk_month": 9,
  "risk_year": 2026,
  "score_change": 0.0,
  "sensitivity_score": 6.36,
  "structural_score": 4.34,
  "summary": "Soybean Farming in the US: overall risk 5.35, steady (was 5.35).",
  "title": "Soybean Farming in the US",
  "volatility": "High",
  "z_score": 0.45
}
```

### Get risk report sections

Get any sections of an industry risk report, such as the score analysis, sensitivities or risk components, as IBISWorld gives them.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany).
- Industry (`code`, text, required): The industry's risk report. Pick one, or give its IBISWorld code from 'List risk reports' or an earlier step.
- Sections (`sections`, list, required): The sections to get. One or more of: `title`, `mainactivities` (Main activities), `definition`, `publicationdate` (Publication date), `riskforecastyear` (Risk forecast year), `riskscores` (Risk scores), `overallriskscore` (Overall risk score), `structuralriskscore` (Structural risk score), `sensitivityriskscore` (Sensitivity risk score), `growthriskscore` (Growth risk score), and 18 more.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `content` (object): Every section's data in one object, keyed as IBISWorld names it (KeyStatistics, Definition, SWOT and so on)
- `country` (text): The IBISWorld country code, such as US
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `sections` (list): Each section asked for, in order
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, when the Title section was asked for

**Example output**

```json
{
  "code": "11111",
  "content": {
    "GrowthRiskScoreComponents": {
      "RiskScoreComponents": [
        {
          "Component": "Growth risk",
          "Level": "Low",
          "Score": 3,
          "Trend": null,
          "Weight": 0.07,
          "WeightedScore": null
        }
      ]
    },
    "Title": "Soybean Farming in the US"
  },
  "country": "US",
  "missing_sections": [],
  "sections": [
    {
      "content": {
        "Title": "Soybean Farming in the US"
      },
      "found": true,
      "name": "title",
      "status_code": 200
    },
    {
      "content": {
        "GrowthRiskScoreComponents": {
          "RiskScoreComponents": [
            {
              "Component": "Growth risk",
              "Level": "Low",
              "Score": 3,
              "Trend": null,
              "Weight": 0.07,
              "WeightedScore": null
            }
          ]
        }
      },
      "found": true,
      "name": "growthriskscore",
      "status_code": 200
    }
  ],
  "summary": "2 of 2 sections of Soybean Farming in the US (US).",
  "title": "Soybean Farming in the US"
}
```

### Get state or provincial industry report

Get sections of an industry report for one US state or Canadian province: performance, outlook, county figures and key statistics.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada).
- State or province (`region`, text, required): The US state or Canadian province, to list its reports. One of: `AL` (Alabama), `AK` (Alaska), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `FL` (Florida), `GA` (Georgia), and 53 more.
- Report (`code`, text, required): The report. Pick one, or give its code (such as NY48412) from 'List state and provincial reports' or an earlier step.
- Sections (`sections`, list): The sections to get. Leave empty for every section. One or more of: `title`, `publicationdate` (Publication date), `region`, `currentperformanceanalysis` (Current performance), `outlookanalysis` (Outlook), `regionalindustryperformance` (Regional industry performance), `countyperformance` (County performance), `keyexternaldrivers` (Key external drivers), `keystatistics` (Key statistics), `keystatisticsannualchange` (Key statistics annual change), `keyratios` (Key ratios).
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.

**Outputs**

- `code` (text): The IBISWorld report code, unique within its country
- `content` (object): Every section's data in one object, keyed as IBISWorld names it (KeyStatistics, Definition, SWOT and so on)
- `country` (text): The IBISWorld country code, such as US
- `missing_sections` (list): Sections IBISWorld had no data for in this report, empty when all came back
- `sections` (list): Each section asked for, in order
- `summary` (text): One sentence saying what came back
- `title` (text): The report's title, when the Title section was asked for

**Example output**

```json
{
  "code": "NY48412",
  "content": {
    "RegionName": "New York",
    "Title": "Long-Distance Freight Trucking in New York"
  },
  "country": "US",
  "missing_sections": [],
  "sections": [
    {
      "content": {
        "Title": "Long-Distance Freight Trucking in New York"
      },
      "found": true,
      "name": "title",
      "status_code": 200
    },
    {
      "content": {
        "RegionName": "New York"
      },
      "found": true,
      "name": "region",
      "status_code": 200
    }
  ],
  "summary": "2 of 2 sections of Long-Distance Freight Trucking in New York (US).",
  "title": "Long-Distance Freight Trucking in New York"
}
```

### List business environment profiles

List the economic indicators IBISWorld profiles in a country, such as consumer spending or commodity prices, optionally only those updated between two days.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany).
- Title contains (`title_contains`, text): Only reports whose title has all these words, such as solar power. Leave empty for every report.
- Updated from (`updated_from`, date): Only reports updated on or after this day. Leave both dates empty for every report.
- Updated to (`updated_to`, date): Only reports updated on or before this day. Defaults to today.
- Collection (`collection`, text): Only standard profiles or only producer price indexes. Leave empty for both. One of: `BED` (Business environment profiles), `PPI` (Producer price indexes).
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.
- How many (`limit`, number): The most reports to return. Leave empty for all of them. From 1 to 5000.

**Outputs**

- `count` (number): How many reports came back
- `reports` (list): The reports, A to Z by title, or newest first when updated
- `summary` (text): One sentence saying what came back
- `total` (number): How many matched before 'How many' cut the list

**Example output**

```json
{
  "count": 1,
  "reports": [
    {
      "code": "I302",
      "collection": "SPE",
      "country": "US",
      "language": "English",
      "last_modified_date": "",
      "published_date": "2025-08-26T13:01:12",
      "title": "Total advertising expenditure"
    }
  ],
  "summary": "1 business environment profiles for US.",
  "total": 1
}
```

### List classification codes

List the codes and titles of one classification system, such as every NAICS 2022 industry.

**Inputs**

- Country (`country`, text, required): The country whose classification systems to use, such as United States for NAICS. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Classification system (`classification_system`, text, required): The system to list, such as NAICS 2022.
- Levels (`tiers`, list): Only codes at these levels of detail. Leave empty for every level. One or more of: `1` (Tier 1 (sectors)), `2` (Tier 2), `3` (Tier 3), `4` (Tier 4), `5` (Tier 5 (most detailed)).
- Sectors (`sector_codes`, list): Only codes in these top level sectors, such as 11 for agriculture in NAICS. Leave empty for every sector.
- Title contains (`title_contains`, text): Only codes whose title has all these words. Leave empty for every code.
- How many (`limit`, number): The most codes to return. Leave empty for all of them. From 1 to 5000.

**Outputs**

- `codes` (list): The codes, in IBISWorld's order
- `count` (number): How many codes came back
- `summary` (text): One sentence saying what came back
- `total` (number): How many matched before 'How many' cut the list

**Example output**

```json
{
  "codes": [
    {
      "classification_system": "NAICS 2022 - USA",
      "code": "11111",
      "parent_code": "1111",
      "sector_code": "11",
      "tier": 4,
      "title": "Soybean Farming",
      "version": "NAICS-2022-USA"
    },
    {
      "classification_system": "NAICS 2022 - USA",
      "code": "11115",
      "parent_code": "1111",
      "sector_code": "11",
      "tier": 4,
      "title": "Corn Farming",
      "version": "NAICS-2022-USA"
    }
  ],
  "count": 2,
  "summary": "2 of 2 codes in NAICS-2022-USA.",
  "total": 2
}
```

### List classification systems

List the official industry classification systems IBISWorld maps for a country, such as NAICS 2022 or ANZSIC 2006.

**Inputs**

- Country (`country`, text, required): The country whose classification systems to use, such as United States for NAICS. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.

**Outputs**

- `count` (number): How many systems came back
- `summary` (text): One sentence saying what came back
- `systems` (list): The classification systems

**Example output**

```json
{
  "count": 1,
  "summary": "1 classification systems for US.",
  "systems": [
    {
      "countries": [
        "US"
      ],
      "full_name": "North American Industry Classification System",
      "languages": [
        "en"
      ],
      "max_tier": 5,
      "name": "NAICS 2022 - USA",
      "type": "Industry",
      "version": "NAICS-2022-USA",
      "year": "2022"
    }
  ]
}
```

### List industry reports

List the industry reports your licence covers in a country, optionally by title words or only those updated between two days.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany), `EUR` (Europe), `GL` (Global), `CN` (China), `MX` (Mexico), and 49 more.
- Title contains (`title_contains`, text): Only reports whose title has all these words, such as solar power. Leave empty for every report.
- Updated from (`updated_from`, date): Only reports updated on or after this day. Leave both dates empty for every report.
- Updated to (`updated_to`, date): Only reports updated on or before this day. Defaults to today.
- Collection (`collection`, text): Only reports in this collection. Leave empty for every collection. One of: `COR` (Core reports), `SPE` (Specialized reports), `SPO` (Spotlight reports), `Core-ISIC` (Core reports on ISIC codes).
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.
- How many (`limit`, number): The most reports to return. Leave empty for all of them. From 1 to 5000.

**Outputs**

- `count` (number): How many reports came back
- `reports` (list): The reports, A to Z by title, or newest first when updated
- `summary` (text): One sentence saying what came back
- `total` (number): How many matched before 'How many' cut the list

**Example output**

```json
{
  "count": 2,
  "reports": [
    {
      "code": "56162",
      "collection": "COR",
      "country": "US",
      "language": "English",
      "last_modified_date": "2026-08-08T00:00:00",
      "published_date": "2026-04-04T00:00:00",
      "title": "Security System Services in the US"
    },
    {
      "code": "22111e",
      "collection": "COR",
      "country": "US",
      "language": "English",
      "last_modified_date": "2026-08-08T00:00:00",
      "published_date": "2026-05-31T00:00:00",
      "title": "Solar Power Generation in the US"
    }
  ],
  "summary": "2 industry reports for US.",
  "total": 2
}
```

### List risk reports

List the industry risk reports your licence covers in a country, optionally only those published between two days.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada), `AU` (Australia), `NZ` (New Zealand), `UK` (United Kingdom), `DE` (Germany).
- Title contains (`title_contains`, text): Only reports whose title has all these words, such as solar power. Leave empty for every report.
- Updated from (`updated_from`, date): Only reports updated on or after this day. Leave both dates empty for every report.
- Updated to (`updated_to`, date): Only reports updated on or before this day. Defaults to today.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.
- How many (`limit`, number): The most reports to return. Leave empty for all of them. From 1 to 5000.

**Outputs**

- `count` (number): How many reports came back
- `reports` (list): The reports, A to Z by title, or newest first when updated
- `summary` (text): One sentence saying what came back
- `total` (number): How many matched before 'How many' cut the list

**Example output**

```json
{
  "count": 1,
  "reports": [
    {
      "code": "32312",
      "collection": "COR",
      "country": "US",
      "language": "English",
      "last_modified_date": "",
      "published_date": "2025-09-08T00:00:00",
      "title": "Printing Services in the US"
    }
  ],
  "summary": "1 risk reports for US.",
  "total": 1
}
```

### List state and provincial reports

List the industry reports your licence covers for one US state or Canadian province.

**Inputs**

- Country (`country`, text, required): The country the report covers. One of: `US` (United States), `CA` (Canada).
- State or province (`region`, text, required): The US state or Canadian province. One of: `AL` (Alabama), `AK` (Alaska), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `FL` (Florida), `GA` (Georgia), and 53 more.
- Title contains (`title_contains`, text): Only reports whose title has all these words, such as solar power. Leave empty for every report.
- Language (`language`, text): The report's language. Defaults to English. One of: `English`, `German`, `French`. Default: `English`.
- How many (`limit`, number): The most reports to return. Leave empty for all of them. From 1 to 5000.

**Outputs**

- `count` (number): How many reports came back
- `reports` (list): The reports, A to Z by title, or newest first when updated
- `summary` (text): One sentence saying what came back
- `total` (number): How many matched before 'How many' cut the list

**Example output**

```json
{
  "count": 1,
  "reports": [
    {
      "code": "NY48412",
      "collection": "STA-NY",
      "country": "US",
      "language": "English",
      "last_modified_date": "",
      "published_date": "2025-08-25T00:00:00",
      "title": "Long-Distance Freight Trucking in New York"
    }
  ],
  "summary": "1 industry reports for NY.",
  "total": 1
}
```
