syrto_compare_companies recupera le stesse metriche per più aziende in un’unica chiamata, restituendo i risultati affiancati. È significativamente più veloce rispetto a chiamare syrto_get_company_metrics una volta per azienda.
Quando usare questo strumento
- Confrontare specifici KPI finanziari tra 2 o più aziende affiancate
- Verificare quale azienda ha le migliori prestazioni su una data metrica (es. ROE, EBITDA)
- Ottenere trend di metriche anno su anno per più aziende contemporaneamente
Argomenti
string[]
obbligatorio
Lista di ID aziendali da
syrto_find_company o syrto_lookup_companies_by_tax_id. Minimo 2, massimo 20.string[]
obbligatorio
Slug delle metriche da confrontare (min 1, max 10). Esempi:
["ebitda", "roe", "net_financial_position"]. Usa syrto_search_metric_definitions o syrto_list_available_metrics per trovare slug validi.integer
obbligatorio
Anno fiscale per il confronto (es.
2023).string
"en" per inglese (predefinito) o "it" per italiano.Risposta
Un oggetto JSON con risultati per azienda e una lista di eventuali ID aziendali non riconosciuti.object[]
Un elemento per ogni azienda richiesta (nello stesso ordine di
company_ids), ciascuno con company_id, legal_name e un array years.object[]
Un elemento per anno fiscale. Ciascuno contiene:
year- anno fiscalesize- classificazione PMI UEemployee_count- organico (nullse non disponibile)metrics- lista di oggetti metrica
object[]
Un elemento per ogni slug di metrica richiesto, ciascuno con:
name- nome della metrica leggibileslug- identificativo internovalue- valore numerico (onullse non disponibile)better_when- oggetto conwhen_type:"HIGHER","LOWER","NEAR_TARGET", onull
string[]
ID aziendali della richiesta che non sono stati trovati.
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.
string | null
Presente quando gli slug delle metriche non sono stati riconosciuti (nessun dato restituito per nessuna azienda).
Esempio
Confrontare EBITDA e ROE per due aziende:- Restituisce ogni azienda con le metriche richieste per l’anno specificato
- Controlla
missing_company_idsper verificare che tutte le aziende richieste siano state trovate