Vai al contenuto principale

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.

syrto_get_company_metrics recupera valori di metriche individuali per slug per un’azienda. Usalo quando hai bisogno di metriche specifiche non già coperte da syrto_get_company_analysis — ad esempio, singole voci di bilancio, set di metriche personalizzati o confronti precisi tra aziende.
Per un’analisi finanziaria generale, usa syrto_get_company_analysis — restituisce tutte e quattro le categorie Syrto più i punteggi radar in un’unica chiamata, senza bisogno di cercare gli slug.Per trovare gli slug delle metriche, usa syrto_list_available_metrics o syrto_search_metric_definitions.

​
Quando usare questo strumento

  • Recuperare metriche specifiche non coperte dalle quattro categorie Syrto (es. voci grezze di bilancio, indici di nicchia)
  • Confrontare aziende su un set di metriche personalizzato
  • Ottenere valori di metriche per un anno specifico o su più anni

​
Argomenti

​
company_id
string
obbligatorio
L’ID aziendale da syrto_find_company.
​
metric_slugs
string[]
Lista di slug delle metriche da recuperare (es. ["total_assets", "net_financial_position"]). Se omesso, restituisce tutte le metriche disponibili. Usa syrto_list_available_metrics per scoprire gli slug.
​
year
integer
Anno fiscale da recuperare (es. 2022). Se omesso, restituisce solo l’anno più recente (controllato da last_n_years, che ha valore predefinito 1). Ha la precedenza su last_n_years.
​
last_n_years
integer
Numero di anni più recenti da restituire. Predefinito 1 (solo l’anno più recente). Massimo 5. Passa null per restituire tutti gli anni disponibili. Ignorato quando year è fornito.
​
include_market_data
boolean
Se true, ogni metrica include un campo market_value con il benchmark di settore per il confronto. Predefinito: false.
​
language
string
"en" per inglese (predefinito) o "it" per italiano.
Non è possibile omettere sia metric_slugs che year — questo restituirebbe tutte le metriche su tutti gli anni, superando i limiti di risposta. Fornisci almeno uno dei due.

​
Risposta

Un oggetto JSON con company_name, available_years e dati per anno. Ogni anno contiene:
​
available_years
integer[]
Tutti gli anni fiscali con dati disponibili per questa azienda.
​
year
integer
Anno fiscale.
​
size
string
Classificazione PMI UE per quell’anno.
​
employee_count
float | null
Organico per quell’anno.
​
metrics
object[]
Lista di oggetti metrica, ciascuno con:
  • name — nome della metrica leggibile
  • slug — identificativo interno (usa name per la visualizzazione)
  • value — valore numerico (o null se non disponibile)
  • better_when — oggetto {"when_type": "HIGHER"}, {"when_type": "LOWER"}, {"when_type": "NEAR_TARGET"}, o null
  • market_value — benchmark di settore (solo quando include_market_data è true)
​
radar.efficiency
float | null
Punteggio efficienza (0–100): quanto bene l’azienda converte le risorse in risultati.
​
radar.size
float | null
Punteggio dimensione (0–100): quanto è grande e stabile l’azienda rispetto al suo settore.
​
radar.trajectory_distance / trajectory_angle
float
Movimento anno su anno nello spazio radar.
​
note
string
Nota di contesto sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.

​
Esempio

Ottenere metriche specifiche di bilancio per Barilla: 
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
  "metric_slugs": ["total_assets", "net_financial_position"]
}
Risultato:
  • Restituisce solo le metriche richieste per l’anno più recente per impostazione predefinita
  • Usa last_n_years per i trend, o year per un periodo specifico
  • Usa syrto_list_available_metrics per scoprire gli slug disponibili