Ricerca aziende

syrto_search_companies trova aziende che soddisfano criteri strutturati - settore, regione, dimensione, numero di dipendenti, metriche finanziarie, posizione radar, persone associate, contributi pubblici o una descrizione in linguaggio naturale. A differenza di syrto_find_company (che cerca per nome o codice fiscale), questo strumento filtra per caratteristiche di business.

Se ti serve il numero totale di aziende corrispondenti o statistiche aggregate (ricavi medi, EBITDA mediano, ecc.), usa syrto_aggregate_companies - questo strumento restituisce solo risultati paginati.

Quando usare questo strumento

Trovare aziende in un settore, una regione o una classe dimensionale specifici
Cercare tramite una descrizione in linguaggio naturale di cosa fa l’azienda
Filtrare le aziende per valori di metriche finanziarie o punteggi 1-5
Selezionare per posizione radar, proprietà o contributi pubblici ricevuti

Strumenti correlati: Per la ricerca per nome o codice fiscale, usa Cerca azienda. Per le statistiche aggregate, usa Aggrega aziende. Per il catalogo dei filtri così come lo espone il server, usa Documentazione dei filtri.

Argomenti

object

Un unico oggetto di filtri strutturato. Le sue chiavi di primo livello sono le sezioni documentate qui sotto: anagraphic, state_aids, people, financial e radar. Omettilo per non applicare filtri.Tutti i filtri impostati si combinano in AND, sia all’interno di una sezione sia tra sezioni.

integer

Anno fiscale in cui vengono valutati i filtri annuali. Obbligatorio quando si usa filters.financial (tranne il campo consolidated) o filters.radar, oppure quando si ordina per metrica.

object

Configurazione dell’ordinamento. Omettila per l’ordine predefinito - rilevanza semantica quando anagraphic.semantic_search è impostato, altrimenti l’ordine predefinito dell’API.

Campo	Tipo	Descrizione
`field`	string	`"match_score"` (richiede `anagraphic.semantic_search`) oppure `"metric"`.
`direction`	string	`"desc"` (predefinito) o `"asc"`.
`metric_slug`	string	Obbligatorio quando `field` è `"metric"`. Lo slug della metrica su cui ordinare.

L’ordinamento avviene solo per valore della metrica - l’API non può ordinare per punteggio.Esempio: {"field": "metric", "metric_slug": "revenues_from_sales_and_services", "direction": "desc"}

string

Cursore per la paginazione. Passa il valore end_cursor di una risposta precedente per ottenere la pagina successiva di 25 risultati. Omettilo per la prima pagina.

string

"en" per l’inglese (predefinito) o "it" per l’italiano.

Sezioni dei filtri

Ogni titolo qui sotto è una chiave di primo livello di filters, e i suoi campi si annidano sotto quella chiave. I campi di tipo intervallo accettano {"min": N, "max": N} con almeno un estremo; entrambi gli estremi sono inclusivi.

`anagraphic` - profilo aziendale

Non richiede year.

Campo	Tipo	Descrizione
`nace`	string[]	Codici settoriali EU NACE, fino a 20. Livello rilevato automaticamente: lettera di sezione (`A`-`U`), divisione (2 cifre, es. `"10"`), gruppo (es. `"10.1"`), classe (es. `"10.11"`). Tutti i codici devono essere dello stesso livello.
`nuts`	string[]	Codici regionali EU NUTS, fino a 20. Livello rilevato dalla lunghezza: livello 1 (3 caratteri, `"ITH"`), livello 2 (4 caratteri, `"ITH3"`), livello 3 (5 caratteri, `"ITH35"`). Tutti i codici devono essere dello stesso livello.
`lau`	string[]	Codici comunali EU LAU, fino a 50 - il livello comunale sotto il NUTS 3, es. codici ISTAT italiani `["037006"]`. Si combina con `nuts` e `country_code`.
`country_code`	string	ISO 3166-1 alpha-2, es. `"IT"`, `"DE"`. Si combina con `nuts` e `lau`.
`semantic_search`	string o string[]	Ricerca libera sulle descrizioni aziendali per attività di business - prodotti, servizi, focus settoriale. Fino a 5 query; una lista è in OR, e un’azienda si posiziona sulla query con cui corrisponde meglio. Obbligatorio per `sort_by` con `field: "match_score"`.
`match_cutoff`	float	Similarità semantica minima per `semantic_search` (0.0-1.0), applicata a ogni query. Predefinito `0.8`, tarato per l’individuazione di peer. Più alto = meno risultati, più pertinenti.
`age`	intervallo	Età dell’azienda in anni.
`shareholder_age`	intervallo	Età media in anni dei soci.
`beneficial_owner_age`	intervallo	Età media in anni dei titolari effettivi.
`executive_officer_age`	intervallo	Età media in anni degli amministratori esecutivi (CEO, amministratori delegati).
`representation_and_authority_officer_age`	intervallo	Età media in anni degli amministratori con poteri di rappresentanza e firma.
`target_market`	enum	Uno tra `B2B`, `B2C`, `B2G`, `B2B2C`, `B2B2G`, `C2C`, `C2B`, `G2C`, `G2B`.
`controlling_entity_category`	enum	La categoria dell’entità che controlla l’azienda: `FAMILY`, `FAMILY_OWNED_GROUP`, `FINANCIALLY_OWNED_GROUP`, `INDUSTRIAL_GROUP`, `FINANCIAL`, `OTHER`.

semantic_search cerca solo l’attività di business - non la ragione sociale, i dati finanziari, la proprietà o la forma giuridica. Usa una lista per alternative reali (“pannelli solari” OPPURE “turbine eoliche”); mantieni una query per attività, perché la corrispondenza è per significato e non per parola chiave.

{"anagraphic": {"nace": ["C"], "nuts": ["ITH3"], "age": {"min": 5}, "target_market": "B2B"}}

`state_aids` - contributi pubblici ricevuti

Non richiede year - il riepilogo non è per esercizio. Gli importi sono in EUR.

Campo	Tipo	Descrizione
`total_amount`	intervallo	Totale aiuti di Stato ricevuti, storico completo.
`amount_last_36_months`	intervallo	Aiuti ricevuti negli ultimi 36 mesi.
`count_last_36_months`	intervallo intero	Numero di contributi negli ultimi 36 mesi.
`above_sector_median_last_36_months`	boolean	`true` mantiene solo le aziende i cui aiuti degli ultimi 36 mesi superano la mediana del loro settore; `false` mantiene quelle pari o inferiori.
`de_minimis_remaining`	intervallo	Massimale de minimis residuo prima della soglia regolamentare. Usa `{"min": 1}` per trovare aziende che possono ancora ricevere aiuti de minimis.
`last_grant_date`	intervallo di date	Data del contributo più recente, come `{"after": "YYYY-MM-DD", "before": "YYYY-MM-DD"}` - almeno un estremo, inclusivo.

{"state_aids": {"amount_last_36_months": {"min": 500000}, "de_minimis_remaining": {"min": 1}}}

`people` - persone associate

Non richiede year. Risolvi prima gli ID delle persone con syrto_find_person. All’interno di ogni lista corrisponde una qualsiasi delle persone indicate; i campi di relazione impostati si combinano in AND.

Campo	Tipo	Descrizione
`officers`	object[]	Fino a 20 voci `{"person_id": "...", "role_category": "..."}`. `role_category` è opzionale; i valori validi sono `GOVERNING_BODIES`, `ADMINISTRATION_AND_EXECUTIVES`, `AUDITING`, `REPRESENTATION_AND_AUTHORITY`, `EXTRAORDINARY_PROCEDURES`, `FUNCTIONAL_ROLES`, `PARTICIPATION_OWNERSHIP`, `CHIEF_EXECUTIVE_OFFICER`, `OTHER`.
`shareholder_ids`	string[]	Fino a 20 ID di persone che sono soci.
`beneficial_owner_ids`	string[]	Fino a 20 ID di persone che sono titolari effettivi.

{"people": {"officers": [{"person_id": "person-id", "role_category": "CHIEF_EXECUTIVE_OFFICER"}]}}

`financial` - dimensione, dipendenti, valori e punteggi delle metriche

Richiede year per size, employees e metric_filters. Senza di esso ogni azienda viene misurata su un periodo di riferimento diverso.

Campo	Tipo	Descrizione
`size`	enum[]	Fasce dimensionali `"XS"`, `"S"`, `"M"`, `"L"`. È la fascia discreta - distinta da `radar.size`, che è un punteggio 0-100.
`employees`	intervallo intero	Numero di dipendenti, es. `{"min": 50, "max": 250}`.
`metric_filters`	object[]	Fino a 10 vincoli per metrica. Vedi sotto.
`consolidated`	boolean	Bilanci consolidati (`true`) o non consolidati (`false`, predefinito). Questo campo da solo non richiede `year`.

Ogni voce di metric_filters è {"slug": ..., "min": N, "max": N, "score_min": 1-5, "score_max": 1-5} con almeno uno dei quattro vincoli. Trova gli slug validi con syrto_search_metric_definitions.

min / max vincolano il valore grezzo sulla scala nativa dell’API, mai moltiplicato per 100: passa 0.1 per “EBIT margin pari o superiore al 10%”, 1.2 per “ROI pari o superiore al 120%”. I valori possono essere negativi, es. -0.15 per un margine del -15%.
score_min / score_max vincolano il punteggio - la valutazione 1-5 che l’API attribuisce a quel valore rispetto al mercato di riferimento dell’azienda. È già normalizzato per direzione, quindi 5 è sempre il punteggio migliore comunque si legga la metrica grezza. Usalo per “aziende con punteggio 4 o 5 sul ROE” senza sapere cosa sia un buon ROE in quel settore.
I vincoli di valore e di punteggio sulla stessa voce si combinano in AND: {"slug": "roe", "min": 0.2, "score_min": 4} significa ROE pari o superiore al 20% e valutato 4+.
Le aziende senza punteggio per la metrica vengono escluse da qualsiasi vincolo di punteggio, incluso uno score_max - un punteggio assente non equivale mai a un punteggio basso. Alcune metriche non vengono mai valutate (il loro better_if risulta vuoto da syrto_search_metric_definitions); un vincolo di punteggio su una di queste non corrisponde a nulla, quindi filtrale per valore.

{"financial": {"size": ["M"], "employees": {"min": 50}, "metric_filters": [{"slug": "ebitda", "min": 1000000}, {"slug": "roe", "score_min": 4}]}}

`radar` - posizione Syrto Radar

Richiede year. Il piano radar ha due assi sintetici proprietari 0-100: size (quanto è grande complessivamente un’azienda) ed efficiency (quanto è buona complessivamente). Lo stesso punteggio significa la stessa cosa in ogni settore.

Campo	Tipo	Descrizione
`size`	intervallo 0-100	Intervallo inclusivo sull’asse dimensione (orizzontale). Diverso dalla fascia `financial.size` (XS-L) e dal numero di dipendenti.
`efficiency`	intervallo 0-100	Intervallo inclusivo sull’asse efficienza (verticale). Più alto è meglio.
`polygon`	object	Una regione arbitraria sul piano (size, efficiency), come `{"vertices": [{"size": 80, "efficiency": 80}, ...]}` - da 3 a 64 vertici, ogni coordinata 0-100.

Imposta almeno uno tra size, efficiency e polygon. Usa gli intervalli sugli assi per rettangoli o fasce allineati agli assi, e polygon per triangoli, forme a L o regioni concave.

{"radar": {"efficiency": {"min": 70}, "size": {"min": 40, "max": 70}}}

Deve essere fornito almeno un filtro. Restituisce fino a 25 risultati per pagina - usa end_cursor dalla risposta come parametro after per ottenere la pagina successiva.

Risposta

boolean

Se sono disponibili altri risultati oltre la pagina corrente.

object[]

Lista delle aziende corrispondenti (fino a 25), ciascuna con:

id - il company_id da passare agli altri strumenti Syrto
legal_name - ragione sociale ufficiale
tax_id - codice fiscale italiano (null se non disponibile)
match_score - punteggio di similarità semantica (solo quando si usa semantic_search)
short_description - breve descrizione dell’attività (solo quando si usa semantic_search)
metrics - lista di oggetti metrica con name, slug, value, better_when (solo quando si usano metric_filters o un ordinamento per metrica)

string | null

Token del cursore per la pagina successiva. Passalo come parametro after. null quando non ci sono altre pagine.

string

Nota contestuale sulla disponibilità dei dati e dove trovare di più su syrto.ai.

string

Link all’app web di Syrto, dove puoi esplorare più dati e approfondimenti.

Esempio

Trovare grandi aziende manifatturiere in Emilia-Romagna:

{
  "filters": {
    "anagraphic": { "nace": ["C"], "nuts": ["ITH5"] },
    "financial": { "size": ["L"] }
  },
  "year": 2023
}

Trovare produttori di solare o eolico ben valutati con margine di aiuti pubblici:

{
  "filters": {
    "anagraphic": {
      "semantic_search": ["produzione di pannelli solari", "produzione di turbine eoliche"],
      "country_code": "IT"
    },
    "financial": {
      "metric_filters": [{ "slug": "roe", "score_min": 4 }]
    },
    "state_aids": { "de_minimis_remaining": { "min": 1 } }
  },
  "year": 2023
}

​Quando usare questo strumento

​Argomenti

​Sezioni dei filtri

​anagraphic - profilo aziendale

​state_aids - contributi pubblici ricevuti

​people - persone associate

​financial - dimensione, dipendenti, valori e punteggi delle metriche

​radar - posizione Syrto Radar

​Risposta

​Esempio

Quando usare questo strumento

Argomenti

Sezioni dei filtri

`anagraphic` - profilo aziendale

`state_aids` - contributi pubblici ricevuti

`people` - persone associate

`financial` - dimensione, dipendenti, valori e punteggi delle metriche

`radar` - posizione Syrto Radar

Risposta

Esempio