> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Spider graphs

> Get thematic financial performance across spider graph axes for a company.

`syrto_get_spider_data` returns performance scores across N thematic axes per template (e.g. operational profitability, autonomy, capacity, operating cash flow, reliability). Each axis has a normalised value from 0 to 5.

## Radar vs. spider

Spider graphs are distinct from the radar chart:

|             | Radar                                                      | Spider                                                    |
| ----------- | ---------------------------------------------------------- | --------------------------------------------------------- |
| **Tool**    | `syrto_get_company_analysis` / `syrto_get_company_metrics` | `syrto_get_spider_data`                                   |
| **Axes**    | 2 (Efficiency, Size)                                       | N thematic axes per template                              |
| **Scale**   | 0–100                                                      | 0–5                                                       |
| **Answers** | "Where does this company stand overall?"                   | "How does it perform on profitability / autonomy / etc.?" |

## 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](/mcp/tools/company-analysis)

## Arguments

<ParamField query="company_id" type="string" required>
  The company ID from [`syrto_find_company`](/mcp/tools/find-company).
</ParamField>

<ParamField query="year" type="integer">
  Year to retrieve (e.g. `2022`). If omitted, returns the most recent year plus the prior year (controlled by `include_prior_year`).
</ParamField>

<ParamField query="include_prior_year" type="boolean">
  When `true` (default), returns the most recent year plus the prior year for trend context. When `false`, returns only the most recent year. Ignored when `year` is provided.
</ParamField>

<ParamField query="language" type="string">
  `"en"` for English (default) or `"it"` for Italian.
</ParamField>

## Returns

A JSON object with `company_name`, `available_years`, and per-year spider data. Each year contains a list of spider templates:

<ResponseField name="available_years" type="integer[]">
  All years with spider data for this company.
</ResponseField>

<ResponseField name="display_name" type="string">
  Human-readable template name (use this for display, not `template_slug`).
</ResponseField>

<ResponseField name="template_slug" type="string">
  Internal template identifier.
</ResponseField>

<ResponseField name="axes" type="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
</ResponseField>

<ResponseField name="note" type="string">
  Context note about data availability and where to find more on syrto.ai.
</ResponseField>

## Example

**Spider breakdown for Barilla:**

```json theme={null}
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox"
}
```

**Response (abbreviated):**

```json theme={null}
{
  "result": {
    "company_name": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
    "years": [
      {
        "year": 2024,
        "spiders": [
          {
            "display_name": "Management Style",
            "axes": [
              { "display_name": "Stability", "current_value": { "value": 2.0 } },
              { "display_name": "Operating Profitability", "current_value": { "value": 2.75 } },
              { "display_name": "Autonomy", "current_value": { "value": 2.33 } }
            ]
          }
        ]
      }
    ]
  },
  "note": "This is a preview of Syrto data. More metrics, benchmarks, and insights are available at https://www.syrto.ai"
}
```
