Company data

Estimate a company's revenue from its headcount

companies_estimate · Reads only · Markdown

A revenue estimate from headcount and Eurostat's turnover per person employed for the size class and industry, always labeled as an estimate.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Kuechentechnik Nord files no revenue, but it has 14 staff. Roughly how big is it?

Your agent callscompanies_estimateFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "employees": 14,
  "industry": "46.69",
  "country": "DE"
}
What comes back
{
  "estimate": {
    "revenue": 6734239,
    "currency": "EUR",
    "is_estimate": true
  },
  "employees": 14,
  "country": "DE",
  "industry": {
    "scheme": "NACE Rev. 2",
    "code": "46.69",
    "label": "Wholesale of other machinery and equipment"
  },
  "turnover_per_person_employed": {
    "used": "size_class",
    "industry": {
      "value": 445558.61,
      "year": 2024,
      "nace": "46.69",
      "turnover_million_eur": 89401.78,
      "persons_employed": 200651
    },
    "size_class": {
      "value": 481017.07,
      "year": 2024,
      "nace": "46.6",
      "class": "10 to 19 persons employed",
      "turnover_million_eur": 15101.05,
      "persons_employed": 31394
    }
  },
  "method": "An estimate, not a filed figure: employees x net turnover per person employed in Eurostat's structural business statistics, for the company's size class where Eurostat publishes it (by NACE group), else for its industry (by NACE class). Companies in one class differ widely.",
  "sources": [
    {
      "dataset": "sbs_ovw_act",
      "nace_r2": "G4669",
      "geo": "DE",
      "url": "https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/sbs_ovw_act",
      "license": "CC BY 4.0 (Eurostat)"
    },
    {
      "dataset": "sbs_sc_ovw",
      "nace_r2": "G466",
      "geo": "DE",
      "size_emp": "10-19",
      "url": "https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/sbs_sc_ovw",
      "license": "CC BY 4.0 (Eurostat)"
    }
  ]
}

Use it when

When a company files no revenue, to size it before a first offer.

What it does

An estimate for a company that files no revenue, always labeled as one: employees x Eurostat's net turnover per person employed for its size class (by NACE group) where Eurostat publishes it, else for its industry (by NACE class), in its EU or EEA country, with both figures, the year and the datasets. Never mixed into filed figures. companies_get gives the industry code and, where published, the employees.

What comes back

estimate (revenue, currency, is_estimate), employees, country, industry, turnover_per_person_employed (used, and size_class and industry: value, year, nace, turnover and persons), method and sources. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
employeesRequiredinteger1 to 1,000,000.
industryRequiredstringA NACE Rev. 2 code such as 46.69 (a French NAF code like 46.69C works too); for an industry on NACE Rev. 2.1, one of its rev2 codes. 2 to 10 characters.
countryRequiredstringTwo letters, e.g. DE. Matches ^[A-Za-z]{2}$.
yearintegerThe statistics' year; the latest published when left out. 2,015 to 2,100.

The call

Over MCP, call companies_estimate on https://api.conecto.chat/mcp/companies. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/companies_estimate \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"employees":14,"industry":"46.69","country":"DE"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400The industry isn't a NACE code.Send one like 46.69; companies_get shows it.
not_found404Eurostat publishes no figures for that industry in that country.Try the broader code (46 instead of 46.69).
unavailable503Eurostat didn't answer.Try again in a minute.

More Company data tools

All 9 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md