Search companies

syrto_search_companies finds companies matching structured criteria - sector, region, size, employee count, financial metrics, radar position, associated people, public subsidies, or a natural language description. Unlike syrto_find_company (which searches by name or tax ID), this tool filters by business characteristics.

If you need the total count of matching companies or aggregate statistics (average revenue, median EBITDA, etc.), use syrto_aggregate_companies instead - this tool only returns paginated results.

Use this tool to

Find companies in a specific sector, region, or size class
Search by a natural language description of what the company does
Filter companies by financial metric values or 1-5 scores
Screen by radar position, ownership, or public subsidies received

Related tools: For lookup by company name or tax ID, use Find company. For aggregate statistics, use Aggregate companies. For the filter catalog as the server serves it, use Search filter docs.

Arguments

object

A single structured filter object. Its top-level keys are the filter sections documented below: anagraphic, state_aids, people, financial, and radar. Omit it for no filters.All set filters combine with AND, both within a section and across sections.

integer

Fiscal year the annual filters are evaluated in. Required whenever filters.financial (except its consolidated field) or filters.radar is used, or when sorting by a metric.

object

Sort configuration. Omit for the default order - semantic relevance when anagraphic.semantic_search is set, otherwise the API’s own default.

Field	Type	Description
`field`	string	`"match_score"` (requires `anagraphic.semantic_search`) or `"metric"`.
`direction`	string	`"desc"` (default) or `"asc"`.
`metric_slug`	string	Required when `field` is `"metric"`. The metric slug to sort by.

Sorting is by metric value only - the API cannot rank by score.Example: {"field": "metric", "metric_slug": "revenues_from_sales_and_services", "direction": "desc"}

string

Cursor for pagination. Pass the end_cursor value from a previous response to fetch the next page of 25 results. Omit for the first page.

string

"en" for English (default) or "it" for Italian.

Filter sections

Each heading below is a top-level key of filters, and its fields nest under that key. Range fields take {"min": N, "max": N} with at least one bound; both bounds are inclusive.

`anagraphic` - company profile

Does not require year.

Field	Type	Description
`nace`	string[]	EU NACE sector codes, up to 20. Level auto-detected: section letter (`A`-`U`), division (2 digits, e.g. `"10"`), group (e.g. `"10.1"`), class (e.g. `"10.11"`). All codes must be the same level.
`nuts`	string[]	EU NUTS region codes, up to 20. Level auto-detected by length: level 1 (3 chars, `"ITH"`), level 2 (4 chars, `"ITH3"`), level 3 (5 chars, `"ITH35"`). All codes must be the same level.
`lau`	string[]	EU LAU municipality codes, up to 50 - the comune level below NUTS 3, e.g. Italian ISTAT codes `["037006"]`. Combines with `nuts` and `country_code`.
`country_code`	string	ISO 3166-1 alpha-2, e.g. `"IT"`, `"DE"`. Combines with `nuts` and `lau`.
`semantic_search`	string or string[]	Free-text search over company descriptions by business activity - products, services, industry focus. Up to 5 queries; a list is ORed, and a company ranks on its best-matching query. Required for `sort_by` with `field: "match_score"`.
`match_cutoff`	float	Minimum semantic similarity for `semantic_search` (0.0-1.0), applied to every query. Default `0.8`, tuned for peer discovery. Higher = fewer, more relevant matches.
`age`	range	Company age in years.
`shareholder_age`	range	Average age in years of shareholders.
`beneficial_owner_age`	range	Average age in years of beneficial owners.
`executive_officer_age`	range	Average age in years of executive officers (CEO, managing directors).
`representation_and_authority_officer_age`	range	Average age in years of officers with representation and signing authority.
`target_market`	enum	One of `B2B`, `B2C`, `B2G`, `B2B2C`, `B2B2G`, `C2C`, `C2B`, `G2C`, `G2B`.
`controlling_entity_category`	enum	The category of entity that controls the company: `FAMILY`, `FAMILY_OWNED_GROUP`, `FINANCIALLY_OWNED_GROUP`, `INDUSTRIAL_GROUP`, `FINANCIAL`, `OTHER`.

semantic_search searches business activity only - not company name, financials, ownership, or legal form. Use a list for genuine alternatives (“solar panels” OR “wind turbines”); keep one query per activity, since matching is by meaning rather than keyword.

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

`state_aids` - public subsidies received

Does not require year - the summary is not per-fiscal-year. Amounts are in EUR.

Field	Type	Description
`total_amount`	range	Total state aid received, all time.
`amount_last_36_months`	range	Aid received in the trailing 36 months.
`count_last_36_months`	int range	Number of grants in the trailing 36 months.
`above_sector_median_last_36_months`	boolean	`true` keeps only companies whose trailing-36-month aid is above their sector’s median; `false` keeps those at or below it.
`de_minimis_remaining`	range	Remaining de minimis allowance before the regulatory ceiling. Use `{"min": 1}` to find companies that can still receive de minimis aid.
`last_grant_date`	date range	Date of the most recent grant, as `{"after": "YYYY-MM-DD", "before": "YYYY-MM-DD"}` - at least one bound, inclusive.

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

`people` - associated people

Does not require year. Resolve person IDs first with syrto_find_person. Within each list, any listed person matches; the relationship fields you set combine with AND.

Field	Type	Description
`officers`	object[]	Up to 20 entries of `{"person_id": "...", "role_category": "..."}`. `role_category` is optional; valid values are `GOVERNING_BODIES`, `ADMINISTRATION_AND_EXECUTIVES`, `AUDITING`, `REPRESENTATION_AND_AUTHORITY`, `EXTRAORDINARY_PROCEDURES`, `FUNCTIONAL_ROLES`, `PARTICIPATION_OWNERSHIP`, `CHIEF_EXECUTIVE_OFFICER`, `OTHER`.
`shareholder_ids`	string[]	Up to 20 person IDs who are shareholders.
`beneficial_owner_ids`	string[]	Up to 20 person IDs who are beneficial owners.

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

`financial` - size, employees, metric values and scores

Requires year for size, employees, and metric_filters. Without it each company is measured against a different reference period.

Field	Type	Description
`size`	enum[]	Company size bands `"XS"`, `"S"`, `"M"`, `"L"`. This is the discrete band - distinct from `radar.size`, which is a 0-100 score.
`employees`	int range	Employee headcount, e.g. `{"min": 50, "max": 250}`.
`metric_filters`	object[]	Up to 10 per-metric bounds. See below.
`consolidated`	boolean	Consolidated (`true`) or non-consolidated (`false`, default) financial statements. This field alone does not require `year`.

Each metric_filters entry is {"slug": ..., "min": N, "max": N, "score_min": 1-5, "score_max": 1-5} with at least one of the four bounds. Find valid slugs with syrto_search_metric_definitions.

min / max bound the raw value on the API’s native scale, never multiplied by 100: pass 0.1 for “EBIT margin at or above 10%”, 1.2 for “ROI at or above 120%”. Values may be negative, e.g. -0.15 for a -15% margin.
score_min / score_max bound the score - the API’s own 1-5 rating of that value against the company’s reference market. It is already normalised for direction, so 5 is always the best rating whichever way the raw metric reads. Use it for “companies scoring 4 or 5 on ROE” without knowing what a good ROE is in that sector.
Value and score bounds on the same entry combine with AND: {"slug": "roe", "min": 0.2, "score_min": 4} means ROE at or above 20% and rated 4+.
Companies with no score for the metric are excluded by any score bound, including a score_max one - an absent score never counts as a low score. Some metrics are never scored at all (their better_if comes back empty from syrto_search_metric_definitions); a score bound on one of those matches nothing, so filter those by value instead.

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

`radar` - Syrto radar position

Requires year. The radar plane has two proprietary synthetic 0-100 axes: size (how big a company is overall) and efficiency (how good it is overall). The same score means the same thing in every industry.

Field	Type	Description
`size`	range 0-100	Inclusive range on the radar size axis (horizontal). Different from the `financial.size` band (XS-L) and from employee count.
`efficiency`	range 0-100	Inclusive range on the radar efficiency axis (vertical). Higher is better.
`polygon`	object	An arbitrary region over the (size, efficiency) plane, as `{"vertices": [{"size": 80, "efficiency": 80}, ...]}` - 3 to 64 vertices, each coordinate 0-100.

Set at least one of size, efficiency, or polygon. Use axis ranges for axis-aligned rectangles or strips, and polygon for triangles, L-shapes, or concave regions.

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

At least one filter must be provided. Returns up to 25 results per page - use the end_cursor from the response as the after parameter to fetch the next page.

Returns

boolean

Whether more results are available beyond the current page.

object[]

List of matching companies (up to 25), each with:

id - the company_id to pass to other Syrto tools
legal_name - official registered company name
tax_id - Italian tax identifier (null if not available)
match_score - semantic similarity score (only when semantic_search is used)
short_description - brief description of the company’s activity (only when semantic_search is used)
metrics - list of metric objects with name, slug, value, better_when (only when metric_filters or a metric sort is used)

string | null

Cursor token for fetching the next page. Pass this as the after parameter. null when there are no more pages.

string

Context note about data availability and where to find more on syrto.ai.

string

Link to the Syrto web app, where you can explore more data and insights.

Example

Find large manufacturers in Emilia-Romagna:

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

Find well-rated solar or wind manufacturers with public subsidy headroom:

{
  "filters": {
    "anagraphic": {
      "semantic_search": ["solar panel manufacturing", "wind turbine manufacturing"],
      "country_code": "IT"
    },
    "financial": {
      "metric_filters": [{ "slug": "roe", "score_min": 4 }]
    },
    "state_aids": { "de_minimis_remaining": { "min": 1 } }
  },
  "year": 2023
}

Getting started

Tools

Search companies

Use this tool to

Arguments

Filter sections

`anagraphic` - company profile

`state_aids` - public subsidies received

`people` - associated people

`financial` - size, employees, metric values and scores

`radar` - Syrto radar position

Returns

Example

​Use this tool to

​Arguments

​Filter sections

​anagraphic - company profile

​state_aids - public subsidies received

​people - associated people

​financial - size, employees, metric values and scores

​radar - Syrto radar position

​Returns

​Example

Use this tool to

Arguments

Filter sections

`anagraphic` - company profile

`state_aids` - public subsidies received

`people` - associated people

`financial` - size, employees, metric values and scores

`radar` - Syrto radar position

Returns

Example