Cerca aziende

syrto_search_companies trova aziende che corrispondono a criteri strutturati: settore, regione, dimensione, numero di dipendenti, metriche finanziarie o una descrizione in linguaggio naturale. A differenza di syrto_find_company (che cerca per nome o codice fiscale), questo strumento filtra per caratteristiche aziendali.

Se hai bisogno del conteggio totale delle aziende corrispondenti o di 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 dell’attivita dell’azienda
Filtrare aziende per valori di metriche finanziarie (es. ricavi superiori a una soglia)

Strumenti correlati: Per la ricerca per nome o codice fiscale, usa Trova azienda. Per statistiche aggregate, usa Aggrega aziende.

Argomenti

string (JSON object)

Filtri del profilo aziendale come oggetto JSON. Tutti i campi sono opzionali:

Campo	Tipo	Descrizione
`nace`	string	Codice settoriale EU NACE. Rileva automaticamente il livello: lettera di sezione (`A`–`U`), divisione (2 cifre, es. `"10"`), gruppo (es. `"10.1"`), classe (es. `"10.11"`).
`nuts`	string	Codice regionale EU NUTS. Rileva automaticamente il livello: livello 1 (3 caratteri, es. `"ITH"`), livello 2 (4 caratteri, es. `"ITH3"`), livello 3 (5 caratteri, es. `"ITH35"`).
`semantic_search`	string	Descrizione in linguaggio naturale per cercare nei profili aziendali (max 500 caratteri, es. `"renewable energy solar panels"`).
`age`	object	Filtro per eta dell’azienda con `min` e/o `max` in anni. Es. `{"min": 5, "max": 20}`.
`shareholder_age`	object	Eta media dei soci con `min` e/o `max` in anni. Es. `{"min": 50, "max": 70}`.
`beneficial_owner_age`	object	Eta media dei titolari effettivi con `min` e/o `max` in anni. Es. `{"min": 40, "max": 65}`.
`executive_officer_age`	object	Eta media dei dirigenti esecutivi (amministratori delegati, direttori generali) con `min` e/o `max` in anni.
`representation_and_authority_officer_age`	object	Eta media dei membri con poteri di rappresentanza e firma, con `min` e/o `max` in anni.
`target_market`	string	Uno tra: `B2B`, `B2C`, `B2G`, `B2B2C`, `B2B2G`, `C2C`, `C2B`, `G2C`, `G2B`.
`match_cutoff`	float	Punteggio minimo di similarita semantica (0.0–1.0) quando si usa `semantic_search`. Valori piu alti = meno risultati ma piu pertinenti.
`country_code`	string	Codice paese ISO 3166-1 alpha-2 (es. `"IT"`).

Esempio: '{"nace": "C", "nuts": "ITH3", "age": {"min": 5}, "target_market": "B2B"}'

integer

Anno fiscale per i filtri sui dati annuali. Obbligatorio quando si usano size, metric_filters, employees o radar, oppure quando si ordina per metrica.

string[]

Una o piu classificazioni dimensionali: "XS", "S", "M", "L" (es. ["S", "M"]). Richiede year.

string (JSON array)

Fino a 10 filtri per valore di metrica. Ogni oggetto ha slug (obbligatorio), min (opzionale), max (opzionale). Richiede year.Usa syrto_search_metric_definitions per trovare gli slug validi.Esempio: '[{"slug": "revenues_from_sales_and_services", "min": 1000000}]'

string (JSON object)

Filtro per numero di dipendenti con min e/o max. Almeno uno e obbligatorio. Richiede year.Esempio: '{"min": 50, "max": 500}'

string (JSON object)

Filtra per posizione sul piano Radar Syrto (0–100 su entrambi gli assi). Si combina in AND con tutti gli altri filtri. È richiesto almeno uno tra size, efficiency o polygon. Richiede year.

Campo	Tipo	Descrizione
`size`	object	Intervallo 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).
`efficiency`	object	Intervallo inclusivo sull’asse efficiency del Radar con `min` e/o `max` (0–100).
`polygon`	object	Poligono 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 (rettangolo): '{"efficiency": {"min": 70}, "size": {"min": 40, "max": 80}}'Esempio (poligono):

'{"polygon": {"vertices": [{"size": 0, "efficiency": 70}, {"size": 60, "efficiency": 100}, {"size": 100, "efficiency": 70}]}}'

boolean

Filtra per bilanci consolidati. Default: false (non consolidati).

string (JSON object)

Configurazione dell’ordinamento come oggetto JSON. Campi:

Campo	Tipo	Descrizione
`field`	string	`"match_score"` (predefinito, significativo con `semantic_search`) o `"metric"` (ordina per valore di una metrica finanziaria).
`direction`	string	`"desc"` (predefinito) o `"asc"`.
`metric_slug`	string	Obbligatorio quando `field` è `"metric"`. Lo slug della metrica per cui ordinare.

Esempio: '{"field": "metric", "metric_slug": "revenues_from_sales_and_services", "direction": "desc"}'

string

Cursore per la paginazione. Passa il valore end_cursor da una risposta precedente per ottenere la pagina successiva. Ometti per la prima pagina.

È necessario fornire almeno un parametro di filtro. Restituisce fino a 25 risultati per pagina - usa end_cursor dalla risposta come parametro after per ottenere la pagina successiva.

Risposta

boolean

Indica se sono disponibili ulteriori 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 dell’azienda
tax_id - codice fiscale italiano (null se non disponibile)
match_score - punteggio di similarità semantica (float, presente solo quando si usa semantic_search)
short_description - breve descrizione dell’attività aziendale (presente solo quando si usa semantic_search)
metrics - lista di oggetti metrica con name, slug, value, better_when (presente solo quando si usano metric_filters o sort_by con field: "metric")

string | null

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

string

Nota contestuale sulla disponibilita dei dati e dove trovare ulteriori informazioni 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:

{
  "anagraphic_filters": "{\"nace\": \"C\", \"nuts\": \"ITH5\"}",
  "year": 2023,
  "size": ["L"]
}

Risultato:

Filtra per sezione NACE C (manifatturiero), NUTS livello 2 ITH5 (Emilia-Romagna), dimensione L (grande)
Restituisce fino a 25 aziende per pagina; passa end_cursor come after per ottenere ulteriori pagine

​Quando usare questo strumento

​Argomenti

​Risposta

​Esempio

Quando usare questo strumento

Argomenti

Risposta

Esempio