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: company_ids, anagraphic, state_aids, people, financial, and radar.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 20 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.

`company_ids` - a known list of companies

Does not require year. Unlike the others, this one is not an object: it is a JSON array of company IDs directly under filters. Use it to sub-filter a list you already hold - a company’s participations, say, or companies resolved from someone’s own list of tax IDs. Up to 200 IDs, no duplicates, and it combines with every other section.

IDs come only from syrto_find_company or syrto_lookup_companies_by_tax_id. A fabricated ID can silently match the wrong company, and an invalid one fails the whole call - the error reports which entry is invalid, so re-resolve that ID rather than constructing a replacement.
Each ID names one statement, individual or consolidated. No consolidation default is applied when this key is present; set financial.consolidated only to restrict the basis further.
An ID absent from the results matched no row for the supplied criteria - but only once has_next_page is false. Results come one page at a time, so an early page says nothing about the IDs it has not reached.
A filtered search returns only the matches, so “below threshold” and “no filing for that year” look identical. Where the distinction matters, pair the screen with syrto_aggregate_companies over the same ID list and year: company_ids_requested minus company_count is how many IDs had no row at all.

{"company_ids": ["<id1>", "<id2>"], "financial": {"metric_filters": [{"slug": "revenues_from_sales_and_services", "min": 50000000}]}}

`anagraphic` - company profile

Does not require year.

Field	Type	Description
`name`	object	Legal-name screen, case-insensitive. Exactly one of `{"contains": "Farmacia Comunale"}` (the text anywhere in the legal name) or `{"starts_with": "Farmacia"}` (prefix), up to 200 characters. See below.
`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`.
`has_branch_in`	object	Where a company has a registered branch, as opposed to its headquarters: `{"nuts": [...], "country_code": "..."}`, at least one of the two. `nuts` takes up to 20 codes with the same level detection as above. `lau` is not accepted here. See below.
`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. name is matched literally, so pass the name as written - a legal-form suffix such as “S.r.l.” narrows the match to companies whose registered name really carries one. Two spelling rules pull in opposite directions: apostrophes must be the straight ASCII one (Dell'Orto, not a curly variant), while accented letters must be the real character (Nicolò, never NICOLO'). The index stores each in exactly one of those forms; an apostrophe substitute is refused, with the spelling to send instead, while accented letters are passed through untouched. This filter screens and never ranks: results come back in the default order, or in whatever sort_by asks for, with no notion of a better name match. To look one company up by name, use syrto_find_company - name is for combining a name with sector, location or financial criteria. The three location filters - nuts, lau and country_code - match a company’s registered headquarters, not its branches. has_branch_in is the one that matches a branch: a company is kept when any one of its registered branches is in the given area. It combines with the headquarters filters rather than replacing them, so {"nuts": ["ITC4"], "has_branch_in": {"nuts": ["ITF4"]}} means headquartered in ITC4 and holding at least one branch in ITF4. “Companies with a presence in X” is the two questions together - run one search on the headquarters filters and one on has_branch_in. A branch match does not change how results are described: each company still comes back with its headquarters, and no field says which branch matched. For one company’s own registered branches, use Company branches.

{"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 20 results per page - use the end_cursor from the response as the after parameter to fetch the next page. That page size matches the cap on the tools a page of results feeds, so one page can be handed straight to Compare companies, Company overview or Company structure in a single call.

Returns

boolean

Whether more results are available beyond the current page.

object[]

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

id - the company ID to pass to other Syrto tools in their company_ids list
legal_name - official registered company name
tax_id - Italian tax identifier (null if not available)
consolidated - always present. false = the company’s own figures, true = its group’s consolidated figures

Beyond those, each field below is present only when its filter was used, so a result shows the company’s value for whatever you searched on:

Field	Appears with
`short_description`, `match_score`	`anagraphic.semantic_search`
`metrics` - each with `name`, `slug`, `value`, `better_when`, and the 1-5 `score` where the metric has one	`financial.metric_filters`, or a metric sort
`controlling_entity_category`, `target_markets`, `nace`, `nuts`, `lau`, `country_code`	the matching `anagraphic` filter
`founding_year`	`anagraphic.age`
`shareholder_birth_year_average` and the other `*_birth_year_average` fields, as raw values	the matching `anagraphic.*_age` filter
`size`, `employee_count`	the matching `financial` filter
`state_aid_total_amount`, `state_aid_amount_last_36_months`, `state_aid_count_last_36_months`, `state_aid_above_sector_median_last_36_months`, `de_minimis_remaining`	the matching `state_aids` filter
`radar` - `efficiency` and `size`, 0-100	a `radar` filter

state_aids.last_grant_date and anagraphic.has_branch_in are the filters with no echo counterpart.

string | null

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

When nothing matches, items is an empty list and warning suggests how to widen the search - not an error. Beside result, the response carries the fields every tool returns. Here display_title is the matching company’s legal name, or a count of the companies on this page, and subtitle says when more results are available.

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

`company_ids` - a known list of companies

`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

​company_ids - a known list of companies

​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

`company_ids` - a known list of companies

`anagraphic` - company profile

`state_aids` - public subsidies received

`people` - associated people

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

`radar` - Syrto radar position

Returns

Example