Supplier discovery

The supplier_discovery module finds companies that make or supply a product or service. It's built around a product: you specify what you're sourcing, and Search returns the companies that offer it, ranked by product relevance and gated by whatever else you add (geography, size, certification keywords, classification).

Who uses it: procurement and supply-chain teams sourcing or de-risking suppliers; competitive-intelligence and strategy teams mapping who makes what.

Input contract


Requires	a `company_products` filter (the anchor), present as a top-level `and` conjunct.
Allows	all firmographic, classification, location and keyword filters (`company_location`, `company_postcode`, `company_industry`, `company_category`, `company_naics_code`, `company_business_model`, `company_type`, `company_estimated_revenue`, `company_employee_count`, `company_year_founded`, `company_keywords`, `target_markets`).
Exclusion	`company_website` and `veridion_id` with `not_in`, uniquely allowed here, to exclude specific companies (for example suppliers you already have).
Rejects	`company_name` (use `company_lookup`), and identity filters used as a positive anchor.

Behavior

Search ranks results by product relevance (and keyword relevance, if you add company_keywords), then applies every other filter as a gate. It returns distinct companies (each matching company appears once), and result_count is the number of companies that match.

Output

Each result is a full company profile at the root of the result object (identity, classification arrays, addresses, revenue and employee counts, contacts, technologies, and more). See Response fields and types.

Evidence is shown only for text matches (company_products and company_keywords). Structured gates such as location, revenue, and classification are not echoed back, because you already know what you asked for. A result only appears when the whole query passed. supplier_types always lists all of the company's supplier roles for the matched product.

See Explainability (evidence) for the evidence shape of each filter type and the sufficiency rules.

Request

Find manufacturers and distributors of industrial energy-storage systems operating in Germany or the UK, with estimated revenue above 4,000,000:

{
    "module": "supplier_discovery",
    "query": {
        "and": [
            {
                "attribute": "company_products",
                "relation": "match_expression",
                "value": {
                    "match": {
                        "operator": "and",
                        "operands": [
                            {
                                "operator": "or",
                                "operands": [
                                    "energy storage systems",
                                    "battery systems",
                                    "energy storage solutions",
                                    "solar storage",
                                    "battery storage",
                                    "power storage"
                                ]
                            },
                            {
                                "operator": "or",
                                "operands": [
                                    "industrial applications",
                                    "industrial solutions"
                                ]
                            }
                        ]
                    }
                },
                "supplier_types": [
                    "manufacturer",
                    "distributor"
                ]
            },
            {
                "attribute": "company_location",
                "relation": "in",
                "value": [
                    {
                        "country": "DE"
                    },
                    {
                        "country": "GB"
                    }
                ],
                "strictness": 3
            },
            {
                "attribute": "company_estimated_revenue",
                "relation": "greater_than",
                "value": 4000000
            }
        ]
    }
}

Special scenarios

Exclusion lists. Drop suppliers you already work with using company_website or veridion_id with not_in.
Local sourcing. Restrict to a radius with company_location and the within relation ({ address, radius, unit }). See Company proximity.
Where a company operates vs. where it's based. Use strictness on location filters: 1 = HQ only, 2 = non-HQ locations, 3 = any location. The default is 1 (HQ only). See Company location.
Qualify by size or classification. Layer company_estimated_revenue, company_employee_count, company_naics_code, company_industry, or company_business_model as gates.