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_aggregate_companies restituisce riepiloghi statistici (conteggio, media, mediana, min, max) per le aziende che corrispondono ai tuoi filtri. Usalo per comprendere i segmenti di mercato — es. “ricavi medi delle medie aziende manifatturiere in Veneto” o “quante grandi aziende ci sono nel settore C”.
Questo strumento restituisce statistiche aggregate, non dati sulle singole aziende. Per trovare aziende specifiche con gli stessi filtri, usa syrto_search_companies.

​
Quando usare questo strumento

  • Contare le aziende che corrispondono a un insieme di criteri
  • Ottenere statistiche di media, mediana o intervallo per una metrica in un segmento
  • Confrontare un’azienda con il suo segmento di mercato (benchmarking)

​
Argomenti

​
year
integer
obbligatorio
Anno fiscale da aggregare.
​
aggregate_metric_slugs
string (JSON array)
obbligatorio
Array JSON di 1–10 slug di metriche per cui calcolare le statistiche. Usa syrto_search_metric_definitions o syrto_list_available_metrics per trovare gli slug validi.Esempio: '["revenues_from_sales_and_services", "ebitda"]'
​
anagraphic_filters
string (JSON object)
Filtri del profilo aziendale come oggetto JSON. Tutti i campi sono opzionali:
CampoTipoDescrizione
nacestringCodice settoriale EU NACE. Rileva automaticamente il livello: lettera di sezione (A–U), divisione (2 cifre), gruppo (es. "10.1"), classe (es. "10.11").
nutsstringCodice regionale EU NUTS. Rileva automaticamente il livello: livello 1 (3 caratteri), livello 2 (4 caratteri), livello 3 (5 caratteri).
semantic_searchstringDescrizione in linguaggio naturale per cercare nei profili aziendali (max 500 caratteri).
ageobjectFiltro per eta dell’azienda con min e/o max in anni.
shareholder_ageobjectEta media dei soci con min e/o max in anni.
beneficial_owner_ageobjectEta media dei titolari effettivi con min e/o max in anni.
executive_officer_ageobjectEta media dei dirigenti esecutivi (amministratori delegati, direttori generali) con min e/o max in anni.
representation_and_authority_officer_ageobjectEta media dei membri con poteri di rappresentanza e firma, con min e/o max in anni.
target_marketstringUno tra: B2B, B2C, B2G, B2B2C, B2B2G, C2C, C2B, G2C, G2B.
match_cutofffloatPunteggio minimo di similarita semantica (0.0–1.0) quando si usa semantic_search.
country_codestringCodice paese ISO 3166-1 alpha-2 (es. "IT").
Esempio: '{"nace": "C", "nuts": "ITH5"}'
​
size
string[]
Una o più classificazioni dimensionali: "XS", "S", "M", "L" (es. ["S", "M"]).
​
metric_filters
string (JSON array)
Fino a 10 filtri per valore di metrica per restringere la popolazione. Ogni oggetto ha slug (obbligatorio), min (opzionale), max (opzionale).Esempio: '[{"slug": "revenues_from_sales_and_services", "min": 1000000}]'
​
employees
string (JSON object)
Filtro per numero di dipendenti con min e/o max.Esempio: '{"min": 50}'
​
radar
string (JSON object)
Aggrega sulle aziende la cui posizione sul piano Radar Syrto (0–100 su entrambi gli assi) corrisponde al filtro. Si combina in AND con tutti gli altri filtri. È richiesto almeno uno tra size, efficiency o polygon.
CampoTipoDescrizione
sizeobjectIntervallo inclusivo sull’asse size del Radar con min e/o max (0–100). Distinto dal parametro size di primo livello (banda XS/S/M/L).
efficiencyobjectIntervallo inclusivo sull’asse efficiency del Radar con min e/o max (0–100).
polygonobjectPoligono arbitrario sul piano (size, efficiency). Contiene una lista vertices da 3 a 64 punti, ciascuno { "size": 0–100, "efficiency": 0–100 }. Usa gli intervalli sugli assi per rettangoli o fasce; usa il poligono per triangoli, forme a L o regioni concave.
Esempio: '{"efficiency": {"min": 70}}'
​
consolidated
boolean
Filtra per bilanci consolidati. Default: false (non consolidati).
​
language
string
"en" per inglese (default) o "it" per italiano.

​
Risposta

​
years
object[]
Un elemento per ogni anno richiesto, ciascuno contenente:
​
years[].company_count
integer
Numero totale di aziende che corrispondono ai filtri.
​
years[].employee_stats
object
Statistiche sul numero di dipendenti delle aziende corrispondenti:
  • count — numero di aziende con dati sui dipendenti
  • average, median, minimum, maximum — riepiloghi statistici
​
years[].metric_stats
object[]
Un elemento per ogni slug di metrica richiesto, ciascuno con:
  • name — nome leggibile della metrica (usare questo per la visualizzazione, non lo slug)
  • slug — identificatore interno
  • stats.count — numero di aziende con dati per questa metrica
  • stats.average, stats.median, stats.minimum, stats.maximum — riepiloghi statistici
​
years[].radar
object
Statistiche del punteggio Radar delle aziende corrispondenti:
  • efficiency_avg, efficiency_median — riepiloghi del punteggio Efficiency (0–100)
  • size_avg, size_median — riepiloghi del punteggio Size (0–100)
​
note
string
Nota contestuale sulla disponibilita dei dati e dove trovare ulteriori informazioni su syrto.ai.

​
Esempio

Ricavi medi delle grandi aziende manifatturiere in Emilia-Romagna: 
{
  "year": 2023,
  "anagraphic_filters": "{\"nace\": \"C\", \"nuts\": \"ITH5\"}",
  "size": "L",
  "aggregate_metric_slugs": "[\"revenues_from_sales_and_services\"]"
}
Risposta (abbreviata): 
{
  "result": {
    "years": [
      {
        "year": 2023,
        "company_count": 3690,
        "employee_stats": {
          "count": 3045,
          "average": 333.15,
          "median": 201.0
        },
        "metric_stats": [
          {
            "name": "Revenues From Sales And Services",
            "slug": "revenues_from_sales_and_services",
            "stats": {
              "count": 3690,
              "average": 214504329.44,
              "median": 88501574.0
            }
          }
        ],
        "radar": {
          "efficiency_avg": 61.54,
          "efficiency_median": 68.25,
          "size_avg": 80.45,
          "size_median": 80.42
        }
      }
    ]
  },
  "note": "This is a preview of Syrto data. ..."
}