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_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

​
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, es. "10"), gruppo (es. "10.1"), classe (es. "10.11").
nutsstringCodice 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_searchstringDescrizione in linguaggio naturale per cercare nei profili aziendali (max 500 caratteri, es. "renewable energy solar panels").
ageobjectFiltro per eta dell’azienda con min e/o max in anni. Es. {"min": 5, "max": 20}.
shareholder_ageobjectEta media dei soci con min e/o max in anni. Es. {"min": 50, "max": 70}.
beneficial_owner_ageobjectEta media dei titolari effettivi con min e/o max in anni. Es. {"min": 40, "max": 65}.
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. Valori piu alti = meno risultati ma piu pertinenti.
country_codestringCodice paese ISO 3166-1 alpha-2 (es. "IT").
Esempio: '{"nace": "C", "nuts": "ITH3", "age": {"min": 5}, "target_market": "B2B"}'
​
year
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.
​
size
string[]
Una o piu classificazioni dimensionali: "XS", "S", "M", "L" (es. ["S", "M"]). Richiede year.
​
metric_filters
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}]'
​
employees
string (JSON object)
Filtro per numero di dipendenti con min e/o max. Almeno uno e obbligatorio. Richiede year.Esempio: '{"min": 50, "max": 500}'
​
radar
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.
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 (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}]}}'
​
consolidated
boolean
Filtra per bilanci consolidati. Default: false (non consolidati).
​
sort_by
string (JSON object)
Configurazione dell’ordinamento come oggetto JSON. Campi:
CampoTipoDescrizione
fieldstring"match_score" (predefinito, significativo con semantic_search) o "metric" (ordina per valore di una metrica finanziaria).
directionstring"desc" (predefinito) o "asc".
metric_slugstringObbligatorio quando field è "metric". Lo slug della metrica per cui ordinare.
Esempio: '{"field": "metric", "metric_slug": "revenues_from_sales_and_services", "direction": "desc"}'
​
after
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

​
has_next_page
boolean
Indica se sono disponibili ulteriori risultati oltre la pagina corrente.
​
items
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")
​
end_cursor
string | null
Token cursore per ottenere la pagina successiva. Passalo come parametro after. null quando non ci sono altre pagine.
​
note
string
Nota contestuale sulla disponibilita dei dati e dove trovare ulteriori informazioni su syrto.ai.

​
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