List Company Segment
list_company_segmentList companies matching the given segment criteria (country, industry, size, new contacts, webshop and target market, etc.). Consumes the account's shared subscription balance (the same balance used by subscribed Excel exports and REST API usage: included monthly contacts first, then prepaid top-up contacts). A completed call always costs at least 1 unit. Costs 1 company unit per returned company row. Returns paginated, deterministically ordered company rows with source classification attributes (hasWebshop, webshopPlatform, targetMarket). Supports webshopStatus, webshopPlatforms, and targetMarket filters. webshopPlatforms is only valid when webshopStatus is "identified" or omitted. Supports company keyword taxonomy filtering through keywordCategoryFilter. Use list_keyword_categories for broad main categories and search_keyword_subcategories for specific business activities. Pass only canonical returned name values; never pass localized labels or raw keywords. Your account exclusion list always applies automatically and cannot be disabled. Optional customerListMode: "exclude" removes companies on your customer list (net-new prospecting), "limit" returns only customer-list companies, "ignore" or omitted ignores the customer list. Exclude/limit require an active customer list managed in the web app (Company lists). Example: list_company_segment({ countryId: -2460, companyContactFilter: "email", limit: 100, offset: 0 }). For count-only questions, prefer count_company_segment.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of companies to return. Defaults to 100; cannot exceed 100. Use a small value such as 10 when only sample rows are needed. | |
| offset | No | Zero-based offset for paginating deterministic results. Use with limit. | |
| companyId | No | Optional company ID filter. Restricts results to one company when provided. | |
| countryId | Yes | Country ID. Use list_countries to discover valid values. Note: IDs are negative integers as stored in the database (e.g. Finland = -2460, Sweden = -7520, Estonia = -2330). | |
| profitMax | No | In thousands of euros (EUR thousands). Maximum annual profit; negative values are allowed and represent net loss. | |
| profitMin | No | In thousands of euros (EUR thousands). Minimum annual profit; negative values are allowed and represent net loss. | |
| businessId | No | Optional company business ID filter. Normalizes dashes/spaces when matching (e.g. "1234567-8"). | |
| regionName | No | Region/province name (case-insensitive substring match). Use the local-language name as shown in company records, e.g. "Uusimaa", "Stockholm". | |
| turnoverMax | No | In thousands of euros (EUR thousands). Maximum annual turnover. Example: 5000 = EUR 5M turnover. | |
| turnoverMin | No | In thousands of euros (EUR thousands). Minimum annual turnover. Example: 5000 = EUR 5M turnover. | |
| personnelMax | No | Maximum number of employees (headcount) as reported in company records. | |
| personnelMin | No | Minimum number of employees (headcount) as reported in company records. | |
| targetMarket | No | Target market classification: "b2b" = B2B only (1), "b2c" = B2C only (2), "both" = both B2B and B2C (12), "unknown" = crawled but unknown (0), "not_crawled" = not yet crawled (NULL). Omitted includes every state. | |
| industryCodes | No | Industry codes (NACE/TOL) for filtering companies and contacts. Codes match by prefix: a full code like "62010" matches one industry, while a shorter prefix like "62" matches every industry whose code starts with it. Call list_industries first to discover valid codes, then pass the returned id values here. IDs from list_industries are string-typed numeric codes, not integers — pass them as strings. | |
| webshopStatus | No | Webshop classification filter: "identified" = a webshop was found, "not_identified" = crawled and no webshop found, "not_crawled" = not yet crawled. Omitted includes all states including 0 and NULL. | |
| foundedYearMax | No | Latest founding year to include (e.g. 2020). | |
| foundedYearMin | No | Earliest founding year to include (e.g. 2010). | |
| jobFunctionIds | No | Job function IDs for multi-select filters. Use list_job_functions to discover valid values. Finer-grained than mainResponsibilityAreaIds. | |
| customerListMode | No | Optional customer-list mode: "exclude" removes companies on your customer list (net-new prospecting), "limit" returns only customer-list companies that match the other filters, "ignore" or omitted ignores the customer list. "exclude"/"limit" require an active customer list managed in the web app under Company lists; fails with CUSTOMER_LIST_REQUIRED otherwise. The account exclusion list always applies regardless of this setting. | |
| industryGroupIds | No | Industry group IDs for multi-select filters. Use list_industry_groups to discover valid values. | |
| webshopPlatforms | No | Webshop platform names (e.g. "shopify", "woocommerce"). Must be combined with webshopStatus "identified" or omitted; combining with "not_identified" or "not_crawled" is invalid. Values are normalized to lowercase/trimmed. Up to 20 values, each up to 50 characters. | |
| organizationLevels | No | Hierarchy level filter; orthogonal to mainResponsibilityAreaIds/jobFunctionIds. Combine with responsibility filters for e.g. Sales + Top Management. | |
| companyContactFilter | No | Company-level contact-availability filter: "all" = include companies regardless of contact availability, "email" = at least one contact with valid email, "phone" = at least one contact with mobile phone, "both" = at least one contact with both valid email and phone, "either" = at least one contact with a valid email, a phone number, or both. Defaults to "email". Compare with contactInfoFilter on contact tools, which filters each returned contact directly. | |
| keywordCategoryFilter | No | Company keyword taxonomy filter. Use level "main" only with canonical name values returned by list_keyword_categories and level "sub" only with canonical name values returned by search_keyword_subcategories. Copy the returned name, not a localized labels value. any matches at least one item, all requires every item, and none excludes every item; non-empty buckets combine with AND. This filters classified company categories and subcategories, not raw keyword text. | |
| newContactsWithinDays | No | Returns companies that have at least one contact created within the last N days (max 3650). | |
| mainResponsibilityAreaIds | No | Broad functional responsibility area IDs (e.g. IT, Marketing). Use list_main_responsibility_areas to discover valid values. IDs are negative integers as stored in the database (e.g. Sales = -70, IT = -40, Marketing = -60, HR = -30, Finances = -50, Managing Director = -20). Combine with jobFunctionIds or organizationLevels to narrow further. | |
| newResponsibilityAssignmentsWithinDays | No | Returns companies that have at least one contact with such an assignment (max 3650). |