Skip to main content

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_compare_companies fetches the same metrics for multiple companies in a single call, returning results side-by-side. It is significantly faster than calling syrto_get_company_metrics once per company.
Metric slugs must come from syrto_list_available_metrics or syrto_search_metric_definitions. Invalid slugs silently return no data.

​
Use this tool to

  • Compare specific financial KPIs across 2 or more companies side-by-side
  • Check which company performs best on a given metric (e.g. ROE, EBITDA)
  • Get year-on-year metric trends for multiple companies at once
Related tools: For single-company metrics, use Company metrics. For sector-level statistics, use Aggregate companies. To find company IDs first, use Find company or Look up companies by tax ID for batch resolution.

​
Arguments

​
company_ids
string[]
required
List of company IDs from syrto_find_company or syrto_lookup_companies_by_tax_id. Minimum 2, maximum 20.
​
metric_slugs
string[]
required
Metric code slugs to compare (min 1, max 10). Examples: ["ebitda", "roe", "net_financial_position"]. Use syrto_search_metric_definitions or syrto_list_available_metrics to find valid slugs.
​
year
integer
required
Fiscal year for comparison (e.g. 2023).
​
language
string
"en" for English (default) or "it" for Italian.

​
Returns

A JSON object with per-company results and a list of any unrecognized company IDs.
​
companies
object[]
One entry per requested company (in the same order as company_ids), each with company_id, legal_name, and a years array.
​
companies[].years
object[]
One entry per fiscal year. Each contains:
  • year — fiscal year
  • size — EU SME classification
  • employee_count — headcount (null if unavailable)
  • metrics — list of metric objects
​
companies[].years[].metrics
object[]
One entry per requested metric slug, each with:
  • name — human-readable metric name
  • slug — internal identifier
  • value — numeric value (or null if unavailable)
  • better_when — object with when_type: "HIGHER", "LOWER", "NEAR_TARGET", or null
​
missing_company_ids
string[]
Company IDs from the request that were not found.
​
warning
string | null
Present when metric slugs were not recognized (no data returned for any company).

​
Example

Compare EBITDA and ROE for two companies: 
{
  "company_ids": ["Zm86SVRfMDE2NTQwMTAzNDVfVTox", "Zm86SVRfMDAxNTk1NjAzNjZfVTox"],
  "metric_slugs": ["ebitda", "roe"],
  "year": 2023
}
Result:
  • Returns each company with the requested metrics for the specified year
  • Check missing_company_ids to verify all requested companies were found