Skip to main content
syrto_get_spider_data returns performance scores across N thematic axes per template - an axis is a financial category, a template a group of related ones. Each axis has a normalised value from 0 to 5.

​
How to read an axis value

Every axis value is relative, not absolute. It averages 1-5 ratings of the underlying metrics against the company’s reference market: companies in the same NACE class (4-digit) and size band (XS/S/M/L) in the same year, within the same NUTS 1 macro-region - country-wide for size L. It is not a national sector average, and no field in the response names the market that was used. So 3 is roughly the local peer median by construction. Below 3 is underperforming those peers, above 3 is outperforming them - an axis value is not a standalone quality mark. Template and axis names are platform content and change without the server changing. A company typically has several templates, between them covering profitability, cash generation, asset use and management style, but what any one of them is called is only knowable from the display_name in the response.

​
Radar vs. spider

Spider graphs are distinct from the radar chart:

​
Use this tool to

  • Get a thematic financial breakdown across axes like operating profitability, autonomy, or cash flow
  • Compare performance across financial themes
  • Drill into specific areas after a general Company analysis

​
Arguments

​
string[]
required
The company, as a list holding exactly one ID - always a list, like every company tool. IDs come from syrto_find_company or syrto_lookup_companies_by_tax_id.This tool answers for one company. To ask about several in one call, use Compare companies for metrics, Company overview for profiles, or Company structure for ownership.
​
integer[]
Fiscal years to retrieve, as a list even for a single year - [2023] or [2023, 2022]. Up to 10 years, each named once. Results always come back newest-first, whatever order you list them in. Naming a year returns that year alone. Any year the company filed is reachable, however old; available_years lists every year it did file.Mutually exclusive with recent_years - pass one or neither, never both.
​
integer
How many of the most recent filed years to return, 1-10 - for example 3 for a three-year trend. Use this rather than years for a relative request, since it needs no knowledge of which years the company filed.Mutually exclusive with years.
​
boolean
If true, each axis of the newest year returned also carries its description and its composing_metrics - the metrics whose 1-5 ratings the axis averages. Use it to explain why an axis scores high or low. The detail is the same every year, so it is given once, on that year. Default: false.
​
string
"en" for English (default) or "it" for Italian.
When both years and recent_years are omitted, this tool returns the two most recent filed years, so the latest scores arrive with a year of trend context beside them.

​
Returns

A JSON object with company_name, consolidated, available_years, and per-year spider data. Each year contains a list of spider templates:
​
boolean
Which statement these figures are. false = the company’s own individual accounts, true = its group’s consolidated accounts. The two can differ by orders of magnitude, so state which basis a figure is on whenever it is a number someone might check against a published report.
​
integer[]
All years with spider data for this company.
​
string
Human-readable template name (use this for display, not template_slug).
​
string
Internal template identifier.
​
object[]
List of axes, each with:
  • display_name - human-readable axis name
  • template_slug - internal axis identifier
  • current_value.value - score from 0 to 5, relative to the company’s reference market (see above)
With include_axis_details, each axis of the newest year returned also has:
  • description - what the axis measures (null when none is on record)
  • composing_metrics - the metrics whose 1-5 ratings the axis averages, each with a human-readable name and a slug you can pass to Company metrics. This is the axis’s composition, not a weighting or a cause - fetch those metrics to explain a score.
Beside result, the response carries the fields every tool returns. Here display_title is the company’s legal name and subtitle its statement basis and the latest fiscal year returned. warning says when a year you named was not filed, or was filed without spider scores.

​
Example

Spider breakdown for Barilla:
To explain what drives each axis, add "include_axis_details": true. Response (abbreviated):