--- name: "longlists_find" area: "longlists" title: "Build a longlist of companies" price: "$0.02 per company returned" method: "POST" url: "https://api.conecto.chat/v1/tools/longlists_find" mcp_server: "https://api.conecto.chat/mcp/longlists" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/longlists/longlists_find" --- # Build a longlist of companies (`longlists_find`) Companies that fit a brief (industry, headcount, revenue, distance, ownership) from four registers, each scored out of 100 with its reasons. Companies that fit a brief, in any country: from its register where Conecto reads one that lists industries (Conecto's index of its operating companies, or the register live around a point), and from the businesses on the map everywhere else (Overture Maps, and OpenStreetMap daily in Germany). Give the industries as NACE codes and, as the brief needs, headcount and revenue ranges, a point and radius, family-run or part of a group, and the business model in words; each company comes back scored out of 100 with its reasons and its facts, best first. What a source doesn't give earns half marks and says so, and a business from the map has its industry inferred from its listing. Read a register company further with companies_get and companies_financials. Price: $0.02 per company returned. A call that fails costs nothing. ## Use it when To build a target list for an acquisition, or a list of companies like one you know. - For one company by name, use [companies_search](https://conecto.chat/tools/companies/companies_search.md). - For buyers for a company, use [longlists_buyers](https://conecto.chat/tools/longlists/longlists_buyers.md). ## Say this to your agent > Find makers of food-service machinery in France and Norway with 20 to 200 staff and €5 to 100 million revenue that we could buy. ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `industries` | array of strings | yes | NACE Rev. 2 codes: a division (28), a group (28.9) or a class (28.93). Norway and newer Finnish filings are on NACE Rev. 2.1, searched under what each code became. 1 to 10 items. | | | | `countries` | array of strings | no | The countries to search, as ISO codes ("DE", "BR") or names ("Germany", "Brasil"). Any country works: one whose register Conecto reads comes from it, every other from the businesses on the map (Overture Maps, and OpenStreetMap daily in Germany). Left out: the registers Conecto reads. 1 to 30 items. | | | | `employees` | object | no | Headcount range, e.g. {"min": 20, "max": 199}. | | | | `employees.min` | number | no | 0 to 10,000,000,000,000. | | | | `employees.max` | number | no | 0 to 10,000,000,000,000. | | | | `revenue_eur` | object | no | Revenue range in euros (France publishes revenue; elsewhere it counts as unknown). | | | | `revenue_eur.min` | number | no | 0 to 10,000,000,000,000. | | | | `revenue_eur.max` | number | no | 0 to 10,000,000,000,000. | | | | `near` | object | no | Companies with a site within km of a point: 500 km at most, and 50 in France, whose register measures it. | | | | `near.lat` | number | yes, when `near` is given | -90 to 90. | | | | `near.lon` | number | yes, when `near` is given | -180 to 180. | | | | `near.km` | number | yes, when `near` is given | 1 to 500. | | | | `near.place` | string | no | The town, matched where a register gives no coordinates. Up to 100 characters. | | | | `ownership` | string | no | independent: no company leads it; group: part of a group. | `"independent"`, `"group"` | | | `business_model` | string | no | What the companies do, in words a register might use, in English or the country's language ("combi ovens for restaurants, storkjøkken"). It ranks within the industries given: Norway by the purpose companies registered, by meaning; elsewhere by the words of their names, map listings and industries, so give the narrowest class. Up to 300 characters. | | | | `exclude` | array of strings | no | Company ids to leave out, like the ones already contacted. Up to 500 items. | | | | `limit` | integer | no | 1 to 200. | | `50` | ## Example Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. MCP: call `longlists_find` on the MCP server `https://api.conecto.chat/mcp/longlists` with these arguments: ```json { "industries": [ "28.93" ], "countries": [ "FR", "NO" ], "employees": { "min": 20, "max": 199 }, "revenue_eur": { "min": 5000000, "max": 100000000 }, "limit": 30 } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/longlists_find \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"industries": ["28.93"], "countries": ["FR", "NO"], "employees": {"min": 20, "max": 199}, "revenue_eur": {"min": 5000000, "max": 100000000}, "limit": 30}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "longlists_find", "status": "succeeded", "replayed": false, "cost_usd": "$0.60", "balance_usd": "$19.75", "result": { "companies": [ { "id": "fr:946250420", "name": "RATIONAL WITTENHEIM SAS", "country": "FR", "number": "946250420", "status": "active", "city": "Wittenheim", "industry": { "scheme": "NACE Rev. 2", "code": "28.93", "label": "Manufacture of machinery for food, beverage and tobacco processing" }, "founded": "1962-01-01", "employees": { "min": 100, "max": 199 }, "revenue": { "amount": 86582337.0, "currency": "EUR", "year": 2025 }, "net_income": { "amount": 4958926.0, "currency": "EUR", "year": 2025 }, "ownership": { "signal": "independent", "basis": "inferred", "evidence": "No company among its leaders in the register; a group can still own it" }, "source": "https://annuaire-entreprises.data.gouv.fr/entreprise/946250420", "score": 100, "reasons": [ "Industry 28.93 (Manufacture of machinery for food, beverage and tobacco processing): the same industry as asked", "Headcount 100 to 199, inside 20 to 199" ] }, { "id": "fr:875420192", "name": "MAGUIN SAS (K MAGUIN)", "country": "FR", "number": "875420192", "status": "active", "city": "Charmes", "industry": { "scheme": "NACE Rev. 2", "code": "28.93", "label": "Manufacture of machinery for food, beverage and tobacco processing" }, "founded": "1954-01-01", "employees": { "min": 100, "max": 199 }, "revenue": { "amount": 41391398.0, "currency": "EUR", "year": 2024 }, "net_income": { "amount": 4012780.0, "currency": "EUR", "year": 2024 }, "ownership": { "signal": "group", "basis": "stated", "evidence": "Président de SAS: MORET INDUSTRIES PARTICIPATIONS (fr:585781305)" }, "source": "https://annuaire-entreprises.data.gouv.fr/entreprise/875420192", "score": 100, "reasons": [ "Industry 28.93 (Manufacture of machinery for food, beverage and tobacco processing): the same industry as asked", "Headcount 100 to 199, inside 20 to 199" ] } ], "considered": { "FR": 25, "NO": 7 }, "unavailable": [], "notes": [ "Norway's register lists headcount but no revenue in a search: revenue counts as unknown (half marks); companies_financials reads the accounts per company.", "France: with a revenue range, only companies that publish their revenue come back." ], "scoring": "The share of the points the brief asks for: industry 30, headcount 20, revenue 20, distance 15, ownership 15, business model 20. A fact the register doesn't publish earns half its points, and every point has its reason. Where a register's NACE Rev. 2.1 class also holds other industries, the industry earns two thirds; a UK accounts class stands in for headcount, at 15 for a fit." } } ``` `result`: companies (id, name, country, number, city, industry, employees, size (the UK's accounts class), revenue, net_income, ownership with its evidence, description where the register has one, website, distance_km and site near a point, score, reasons, source), considered (companies per register), unavailable, notes and scoring. ## Errors | Code | Status | When | Fix | |---|---|---|---| | `invalid_input` | 400 | An industry code that isn't NACE at the division, group or class level, or a country whose register can't be searched by industry (Germany among them). | Give codes like 28 or 28.93; search German companies by name or HRB number with companies_search. | | `unavailable` | 503 | None of the registers asked answered. | Try again in a minute. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [longlists_buyers](https://conecto.chat/tools/longlists/longlists_buyers.md): Companies that could buy a company, in its industry or the value chain you name and at least twice its size, scored out of 100. $0.05 per buyer returned.