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_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.
Gli slug delle metriche devono provenire da syrto_list_available_metrics o syrto_search_metric_definitions. Slug non validi non restituiscono dati senza segnalare errori.

​
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
Strumenti correlati: Per metriche di una singola azienda, usa Metriche aziendali. Per statistiche a livello di settore, usa Aggrega aziende. Per trovare gli ID aziendali, usa Cerca azienda o Cerca aziende per codice fiscale per la risoluzione in batch.

​
Argomenti

​
company_ids
string[]
obbligatorio
Lista di ID aziendali da syrto_find_company o syrto_lookup_companies_by_tax_id. Minimo 2, massimo 20.
​
metric_slugs
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.
​
year
integer
obbligatorio
Anno fiscale per il confronto (es. 2023).
​
language
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.
​
companies
object[]
Un elemento per ogni azienda richiesta (nello stesso ordine di company_ids), ciascuno con company_id, legal_name e un array years.
​
companies[].years
object[]
Un elemento per anno fiscale. Ciascuno contiene:
  • year — anno fiscale
  • size — classificazione PMI UE
  • employee_count — organico (null se non disponibile)
  • metrics — lista di oggetti metrica
​
companies[].years[].metrics
object[]
Un elemento per ogni slug di metrica richiesto, ciascuno con:
  • name — nome della metrica leggibile
  • slug — identificativo interno
  • value — valore numerico (o null se non disponibile)
  • better_when — oggetto con when_type: "HIGHER", "LOWER", "NEAR_TARGET", o null
​
missing_company_ids
string[]
ID aziendali della richiesta che non sono stati trovati.
​
warning
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: 
{
  "company_ids": ["Zm86SVRfMDE2NTQwMTAzNDVfVTox", "Zm86SVRfMDAxNTk1NjAzNjZfVTox"],
  "metric_slugs": ["ebitda", "roe"],
  "year": 2023
}
Risultato:
  • Restituisce ogni azienda con le metriche richieste per l’anno specificato
  • Controlla missing_company_ids per verificare che tutte le aziende richieste siano state trovate