Aggregate companies

syrto_aggregate_companies returns statistical summaries (count, average, median, min, max) for companies matching your filters. Use it to understand market segments - e.g. “average revenue of medium manufacturing companies in Veneto” or “how many large companies are in sector C”.

This tool returns aggregate statistics, not individual company data. To find specific companies matching the same filters, use syrto_search_companies.

Use this tool to

Count companies matching a set of criteria
Get average, median, or range statistics for a metric across a segment
Benchmark a company against its market segment

Arguments

integer

required

Fiscal year to aggregate.

string[]

required

1-10 metric slugs to compute statistics for. Use syrto_search_metric_definitions or syrto_list_available_metrics to find valid slugs.Example: ["revenues_from_sales_and_services", "ebitda"]

object

A single structured filter object narrowing which companies are aggregated. It takes exactly the same sections as syrto_search_companies: anagraphic, state_aids, people, financial, and radar. Omit it to aggregate over everything.All set filters combine with AND, both within a section and across sections. See Search companies for each section’s fields, or fetch the catalog at runtime with syrto_get_search_filter_docs.An invalid filters object returns an error naming the bad field.

string

"en" for English (default) or "it" for Italian.

Returns

object[]

One entry per requested year, each containing:

integer

Total number of companies matching the filters.

object

Employee count statistics across matching companies:

count - number of companies with employee data
average, median, minimum, maximum - statistical summaries

object[]

One entry per requested metric slug, each with:

name - human-readable metric name (use this for display, not slug)
slug - internal identifier
stats.count - number of companies with data for this metric
stats.average, stats.median, stats.minimum, stats.maximum - statistical summaries

object

Radar score statistics across matching companies:

efficiency_avg, efficiency_median - Efficiency score summaries (0–100)
size_avg, size_median - Size score summaries (0–100)

string

Context note about data availability and where to find more on syrto.ai.

string

Link to the Syrto web app, where you can explore more data and insights.

Example

Average revenue for large manufacturers in Emilia-Romagna:

{
  "year": 2023,
  "aggregate_metric_slugs": ["revenues_from_sales_and_services"],
  "filters": {
    "anagraphic": { "nace": ["C"], "nuts": ["ITH5"] },
    "financial": { "size": ["L"] }
  }
}

Response (abbreviated):

{
  "result": {
    "years": [
      {
        "year": 2023,
        "company_count": 3690,
        "employee_stats": {
          "count": 3045,
          "average": 333.15,
          "median": 201.0
        },
        "metric_stats": [
          {
            "name": "Revenues From Sales And Services",
            "slug": "revenues_from_sales_and_services",
            "stats": {
              "count": 3690,
              "average": 214504329.44,
              "median": 88501574.0
            }
          }
        ],
        "radar": {
          "efficiency_avg": 61.54,
          "efficiency_median": 68.25,
          "size_avg": 80.45,
          "size_median": 80.42
        }
      }
    ]
  },
  "note": "Syrto data summary. ...",
  "source_url": "https://app.syrto.ai"
}

Getting started

Tools

Aggregate companies

Use this tool to

Arguments

Returns

Example

​Use this tool to

​Arguments

​Returns

​Example

Use this tool to

Arguments

Returns

Example