Skip to main content
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

​
string
obbligatorio
L’ID aziendale da syrto_find_company.
​
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.
​
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.
​
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.
​
boolean
Se true, ogni metrica include un campo market_value con il benchmark di settore per il confronto. Predefinito: false.
​
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, consolidated, available_years e dati per anno. Ogni anno contiene:
​
boolean
A quale bilancio si riferiscono questi valori. false = i conti individuali dell’azienda, true = i conti consolidati del suo gruppo. I due possono differire di ordini di grandezza: indica sempre su quale base è un valore quando qualcuno potrebbe confrontarlo con un bilancio pubblicato.
​
integer[]
Tutti gli anni fiscali con dati disponibili per questa azienda.
​
integer
Anno fiscale.
​
string
Data ISO 8601 del bilancio da cui derivano i valori. È la data del bilancio stesso - normalmente la chiusura dell’esercizio - non la data di deposito o pubblicazione. Omesso quando non risulta alcuna data.
​
string
Classificazione PMI UE per quell’anno.
​
float | null
Organico per quell’anno.
​
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
  • score - intero 1-5 che valuta il valore rispetto al mercato di riferimento dell’azienda. È già normalizzato per direzione, quindi 5 è il migliore per ogni metrica, anche per quelle dove un valore grezzo più basso è preferibile - non riordinarlo mai in base a better_when. Omesso quando la metrica non ha una strategia di punteggio.
  • market_value - benchmark di settore (solo quando include_market_data è true)
​
float | null
Punteggio efficienza (0–100): quanto bene l’azienda converte le risorse in risultati.
​
float | null
Punteggio dimensione (0–100): quanto è grande e stabile l’azienda rispetto al suo settore.
​
float
Movimento anno su anno nello spazio radar.
​
string
Nota di contesto sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.
​
string
Link all’app web di Syrto, dove puoi esplorare più dati e approfondimenti.

​
Esempio

Ottenere metriche specifiche di bilancio per Barilla:
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